DocumentExtensions.HasVstoObject 方法 (_Document, ApplicationFactory)
返回一个值,该值指示是否已为应用程序级外接程序中的当前 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。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。
请参见
参考
Microsoft.Office.Tools.Word.Extensions 命名空间