DocumentExtensions.GetVstoObject 方法 (_Document, ApplicationFactory)

项目
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 ApplicationFactory _
) As Document

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

参数

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

factory
类型：Microsoft.Office.Tools.Word.ApplicationFactory
一个对象，该对象提供对应用程序级外接程序中的某些功能的访问。将 Globals.Factory 对象传递到此参数。

返回值

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

使用说明

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

备注

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

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

提示

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。