DocumentExtensions.HasVstoObject 方法 (_Document, ApplicationFactory)

项目
08/12/2011

返回一个值，该值指示是否已为应用程序级外接程序中的当前 Microsoft.Office.Interop.Word.Document 对象创建了一个 Microsoft.Office.Tools.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 HasVstoObject ( _
    document As _Document, _
    factory As ApplicationFactory _
) As Boolean

public static bool HasVstoObject(
    this _Document document,
    ApplicationFactory factory
)

参数

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

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

返回值

类型：System.Boolean
如果已为当前 Microsoft.Office.Interop.Word.Document 对象创建了 Microsoft.Office.Tools.Word.Document 宿主项，则为 true；否则为 false。

使用说明

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

备注

在应用程序级外接程序中，您可以调用此方法以确定任何 Microsoft.Office.Interop.Word.Document 对象是否存在 Microsoft.Office.Tools.Word.Document 宿主项。通常，您可以使用此方法在关闭或保存 Word 文档前测试要保持的托管控件是否存在。

提供此方法是为了与从面向 .NET Framework 3.5 变为面向 .NET Framework 4 的 Office 项目向后兼容。在面向 .NET Framework 4 的新项目中，您应该调用由您项目中的 Globals.Factory 对象提供的 GetVstoObject 方法。有关更多信息，请参见在运行时在应用程序级外接程序中扩展 Word 文档和 Excel 工作簿。

提示

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。