次の方法で共有

ApplicationFactory.GetVstoObject メソッド (_Workbook)

  • [アーティクル]

指定されたネイティブなブック オブジェクトの機能を拡張する Microsoft.Office.Tools.Excel.Workbook ホスト項目を返します。

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

構文

'宣言
Function GetVstoObject ( _
    workbook As _Workbook _
) As Workbook

Workbook GetVstoObject(
    _Workbook workbook
)

パラメーター

戻り値

型 : Microsoft.Office.Tools.Excel.Workbook
ネイティブなブック オブジェクトの機能を拡張するホスト項目です。

解説

このメソッドは、アプリケーション レベルのアドインから、Excel で開いているブックをカスタマイズする際に呼び出します。既存の Microsoft.Office.Tools.Excel.Workbook オブジェクトが存在しない場合は、新しいオブジェクトが生成されます。それ以降の呼び出しでは、既存の Microsoft.Office.Tools.Excel.Workbook オブジェクトのキャッシュされたインスタンスが返されます。詳細については、「アプリケーション レベルのアドインにおける実行時の 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 を使用するのが一般的です。

例

アクティブな Excel ブックの Microsoft.Office.Tools.Excel.Workbook ホスト項目を作成するコード例を次に示します。このコードは、実行 ThisAddIn のクラスから、ターゲット .NET Framework 4 または .NET Framework 4.5を Excel アドイン プロジェクトで使用します。

Dim vstoWorkbook As Workbook = _
    Globals.Factory.GetVstoObject(Me.Application.ActiveWorkbook)

For Each st As SmartTag In vstoWorkbook.VstoSmartTags
    System.Windows.Forms.MessageBox.Show(st.Caption)
Next

Workbook vstoWorkbook =
    Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook);

foreach (SmartTag st in vstoWorkbook.VstoSmartTags)
{
    System.Windows.Forms.MessageBox.Show(st.Caption);
}

.NET Framework セキュリティ

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

参照

関連項目

ApplicationFactory インターフェイス

GetVstoObject オーバーロード

Microsoft.Office.Tools.Excel 名前空間

その他の技術情報

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

ドキュメント レベルのカスタマイズのプログラミング