WorksheetExtensions.GetVstoObject 方法 (_Worksheet, Factory)

2011-08-12

返回一个 Microsoft.Office.Tools.Excel.Worksheet 宿主项，该宿主项可扩展文档级自定义项中的当前 Microsoft.Office.Interop.Excel.Worksheet 对象的功能。将项目中的 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 ( _
    worksheet As _Worksheet, _
    factory As Factory _
) As Worksheet

public static Worksheet GetVstoObject(
    this _Worksheet worksheet,
    Factory factory
)

参数

worksheet
类型：Microsoft.Office.Interop.Excel._Worksheet
要扩展的本机工作表对象。不需要您自己提供此参数。在 Excel 工作表中调用此方法时，运行时会提供此参数。

factory
类型：Microsoft.Office.Tools.Excel.Factory
一个对象，该对象提供对文档级自定义项中的某些功能的访问。将 Globals.Factory 对象传递到此参数。

返回值

类型：Microsoft.Office.Tools.Excel.Worksheet
一个宿主项，该宿主项可扩展当前 Microsoft.Office.Interop.Excel.Worksheet 对象的功能。

使用说明

在 Visual Basic 和 C# 中，可以在 _Worksheet 类型的任何对象上将此方法作为实例方法来调用。当使用实例方法语法调用此方法时，请省略第一个参数。有关更多信息，请参见扩展方法 (Visual Basic)或扩展方法（C# 编程指南）。

备注

在文档级自定义项中，可以调用此方法以获取当前自定义项中的 Microsoft.Office.Tools.Excel.Worksheet 宿主项。如果您对其调用此方法的 Microsoft.Office.Interop.Excel.Worksheet 对象不是当前自定义项中 Microsoft.Office.Tools.Excel.Worksheet 宿主项的基础对象，则此方法返回 nullnull 引用（在 Visual Basic 中为 Nothing）。

提供此方法是为了与从面向 .NET Framework 3.5 变为面向 .NET Framework 4 的 Office 项目向后兼容。在面向 .NET Framework 4 的新项目中，您应该调用由您项目中的 Globals.Factory 对象提供的 GetVstoObject 方法。有关更多信息，请参见从文档级自定义项中的本机 Office 对象获取扩展对象。

提示

worksheet 参数属于 Microsoft.Office.Interop.Excel._Worksheet 类型，后者是 Microsoft.Office.Interop.Excel.Worksheet 的父接口。因此，此方法可扩展以下两种类型：Microsoft.Office.Interop.Excel._Worksheet 和 Microsoft.Office.Interop.Excel.Worksheet。通常，在引用 Excel 工作表时，使用 Microsoft.Office.Interop.Excel.Worksheet。