WorkbookExtensions.GetVstoObject メソッド (_Workbook, ApplicationFactory)

アプリケーションレベルのアドイン内で現在の Microsoft.Office.Interop.Excel.Workbook オブジェクトの機能を拡張する Microsoft.Office.Tools.Excel.Workbook ホスト項目を取得します。プロジェクト内の Globals.Factory オブジェクトを factory パラメーターに渡します。

名前空間: Microsoft.Office.Tools.Excel.Extensions
アセンブリ: Microsoft.Office.Tools.Excel.v4.0.Utilities (Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 内)

構文

'宣言
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    workbook As _Workbook, _
    factory As ApplicationFactory _
) As Workbook

public static Workbook GetVstoObject(
    this _Workbook workbook,
    ApplicationFactory factory
)

パラメーター

workbook
型 : Microsoft.Office.Interop.Excel._Workbook
拡張するネイティブなブックオブジェクト。このパラメーターは手動で指定しないでください。このパラメーターは、Excel ブックでこのメソッドを呼び出したときに、ランタイムによって指定されます。

factory
型 : Microsoft.Office.Tools.Excel.ApplicationFactory
アプリケーションレベルのアドイン内で特定の機能へのアクセスを提供するオブジェクト。 Globals.Factory オブジェクトをこのパラメーターに渡します。

戻り値

型 : Microsoft.Office.Tools.Excel.Workbook
現在の Microsoft.Office.Interop.Excel.Workbook オブジェクトの機能を拡張するホスト項目。

使用上の注意

Visual Basic および Visual C# では、このメソッドを、_Workbook 型のオブジェクトのインスタンスメソッドとして呼び出すことができます。インスタンスメソッド構文を使用してこのメソッドを呼び出す場合は、最初のパラメーターを省略します。詳細については、「拡張メソッド (Visual Basic)」または「拡張メソッド (C# プログラミングガイド)」を参照してください。

解説

アプリケーションレベルのアドインで、このメソッドを呼び出して、Excel で開いているブックを拡張します。このメソッドは、新しい Microsoft.Office.Tools.Excel.Workbook ホスト項目を生成します。これは、そのようなオブジェクトが、このメソッドを呼び出す対象の Microsoft.Office.Interop.Excel.Workbook オブジェクトについてまだ生成されていない場合に行われます。それ以降、同じ Microsoft.Office.Interop.Excel.Workbook オブジェクトでこのメソッドを呼び出すと、同じ Microsoft.Office.Tools.Excel.Workbook インスタンスが返されます。

このメソッドは、Office の下位互換性に .NET Framework 3.5 からに変更 .NET Framework 4 か .NET Framework 4.5ことが削除されます。.NET Framework 4 か .NET Framework 4.5を対象とする新しいプロジェクトでは、プロジェクトの Globals.Factory のオブジェクトによって提供される GetVstoObject のメソッドを呼び出す必要があります。

詳細については、「アプリケーションレベルのアドインにおける実行時の Word 文書や Excel ブックの拡張」を参照してください。

[!メモ]

workbook パラメーターの型は、Microsoft.Office.Interop.Excel.Workbook の親インターフェイスである Microsoft.Office.Interop.Excel._Workbook 型です。したがって、このメソッドは、Microsoft.Office.Interop.Excel._Workbook と Microsoft.Office.Interop.Excel.Workbook の両方の型を拡張します。Excel ブックを参照する場合は、Microsoft.Office.Interop.Excel.Workbook を使用するのが一般的です。

.NET Framework セキュリティ

直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

その他の技術情報

アプリケーションレベルのアドインにおける実行時の Word 文書や Excel ブックの拡張

拡張メソッド (C# プログラミングガイド)

拡張メソッド (Visual Basic)

Last updated on 2013-05-14