Share via

DocumentExtensions.GetVstoObject Method (_Document, ApplicationFactory)

  • Article

Returns a Microsoft.Office.Tools.Word.Document host item that extends the functionality of the current Microsoft.Office.Interop.Word.Document object in an application-level add-in. Pass the Globals.Factory object in your project to the factory parameter.

Namespace:  Microsoft.Office.Tools.Word.Extensions
Assembly:  Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntax

'Declaration
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    document As _Document, _
    factory As ApplicationFactory _
) As Document

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

Parameters

  • document
    Type: Microsoft.Office.Interop.Word._Document
    The native document object to extend. Do not supply this parameter yourself. When you call this method on a Word document, the runtime supplies this parameter.

Return Value

Type: Microsoft.Office.Tools.Word.Document
A host item that extends the functionality of the current Microsoft.Office.Interop.Word.Document object.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type _Document. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

In an application-level add-in, call this method to extend any document that is open in Word. This method generates a new Microsoft.Office.Tools.Word.Document host item if no such object has already been generated for the Microsoft.Office.Interop.Word.Document object on which you call this method. Subsequent calls to this method on the same Microsoft.Office.Interop.Word.Document object return the same Microsoft.Office.Tools.Word.Document instance.

This method is provided for backward compatibility with Office projects that you retarget from the .NET Framework 3.5 to the .NET Framework 4. In new projects that target the .NET Framework 4, you should call the GetVstoObject method that is provided by the Globals.Factory object in your project.

For more information, see Extending Word Documents and Excel Workbooks in Application-Level Add-ins at Run Time.

Note

The document parameter is of type Microsoft.Office.Interop.Word._Document, which is the parent interface of Microsoft.Office.Interop.Word.Document. Therefore, this method extends both types: Microsoft.Office.Interop.Word._Document and Microsoft.Office.Interop.Word.Document. Typically, when you reference a Word document, you use a Microsoft.Office.Interop.Word.Document.

.NET Framework Security

See Also

Reference

DocumentExtensions Class

GetVstoObject Overload

Microsoft.Office.Tools.Word.Extensions Namespace

Other Resources

Extending Word Documents and Excel Workbooks in Application-Level Add-ins at Run Time

Extension Methods (C# Programming Guide)

Extension Methods (Visual Basic)