WorkbookExtensions.GetVstoObject 方法 (_Workbook, ApplicationFactory)

项目
08/12/2011

返回一个 Microsoft.Office.Tools.Excel.Workbook 宿主项，该宿主项可扩展应用程序级外接程序中的当前 Microsoft.Office.Interop.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 和 C# 中，可以在 _Workbook 类型的任何对象上将此方法作为实例方法来调用。当使用实例方法语法调用此方法时，请省略第一个参数。有关更多信息，请参见扩展方法 (Visual Basic)或扩展方法（C# 编程指南）。

备注

在应用程序级外接程序中调用此方法可扩展在 Excel 中打开的任何工作簿。如果没有为对其调用此方法的Microsoft.Office.Interop.Excel.Workbook 对象生成此类对象，此方法将生成一个新的 Microsoft.Office.Tools.Excel.Workbook 宿主项。在 Microsoft.Office.Interop.Excel.Workbook 对象上对此方法的后续调用会返回相同的 Microsoft.Office.Tools.Excel.Workbook 实例。

提供此方法是为了与从面向 .NET Framework 3.5 变为面向 .NET Framework 4 的 Office 项目向后兼容。在面向 .NET Framework 4 的新项目中，您应该调用由您项目中的 Globals.Factory 对象提供的 GetVstoObject 方法。

提示

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。