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# 程式設計手冊)。

備註

在應用程式層級增益集 (Add-In) 內呼叫這個方法，即可擴充任何以 Word 開啟的文件。如果在您呼叫這個方法的 Microsoft.Office.Interop.Word.Document 物件上還沒有產生此類物件，這個方法會產生新的 Microsoft.Office.Tools.Word.Document 主機項目。針對同一個 Microsoft.Office.Interop.Word.Document 物件上的這個方法的後續呼叫會傳回相同的 Microsoft.Office.Tools.Word.Document 執行個體。

這個方法可用於回溯與 Office 專案的相容性 (您在 .NET Framework 3.5 中將這些專案的目標重定為 .NET Framework 4)。在以 .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。