ApplicationFactory.GetVstoObject 方法 (_Workbook)

项目
05/20/2013

返回一个 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
)

参数

workbook
类型：Microsoft.Office.Interop.Excel._Workbook
要为其检索扩展对象的本机工作簿对象。尽管此参数的类型为 Microsoft.Office.Interop.Excel._Workbook，但通常可将 Microsoft.Office.Interop.Excel.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 宿主项。若要使用此代码，请运行该自针对 .NET Framework 4 或 .NET Framework 4.5的 Excel 外接程序项目的 ThisAddIn 选件类。

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);
}