DocumentExtensions.GetVstoObject 方法 (_Document, Factory)

项目
08/12/2011

返回一个 Microsoft.Office.Tools.Word.Document 宿主项，该宿主项可扩展文档级自定义项中的当前 Microsoft.Office.Interop.Word.Document 对象的功能。将项目中的 Globals.Factory 对象传递到 factory 参数。

命名空间： Microsoft.Office.Tools.Word.Extensions
程序集： Microsoft.Office.Tools.Word.v4.0.Utilities（在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中）

语法

声明
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    document As _Document, _
    factory As Factory _
) As Document

public static Document GetVstoObject(
    this _Document document,
    Factory factory
)

参数

document
类型：Microsoft.Office.Interop.Word._Document
要扩展的本机文档对象。不需要您自己提供此参数。在 Word 文档中调用此方法时，运行时会提供此参数。

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

返回值

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

使用说明

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

备注

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

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

提示

document 参数属于 Microsoft.Office.Interop.Word._Document 类型，后者是 Microsoft.Office.Interop.Word.Document 的父接口。因此，此方法可扩展以下两种类型：Microsoft.Office.Interop.Word._Document 和 Microsoft.Office.Interop.Word.Document。通常情况下，引用 Word 文档时，使用 Microsoft.Office.Interop.Word.Document。