DocumentExtensions.GetVstoObject-Methode (_Document, Factory)

Gibt ein Microsoft.Office.Tools.Word.Document-Hostelement zurück, das die Funktionalität des aktuellen Microsoft.Office.Interop.Word.Document-Objekts in einer Anpassung auf Dokumentebene erweitert. Übergeben Sie das Globals.Factory-Objekt im Projekt an den 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 Factory _
) As Document

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

Parameter

document
Typ: Microsoft.Office.Interop.Word._Document
Das zu erweiternde systemeigene Dokumentobjekt.Geben Sie diesen Parameter nicht selbst an.Wenn Sie diese Methode für ein Word-Dokument aufrufen, gibt die Laufzeit diesen Parameter an.

factory
Typ: Microsoft.Office.Tools.Word.Factory
Ein Objekt, das den Zugriff auf bestimmte Funktionen in der Anpassung auf Dokumentebene ermöglicht.Übergeben Sie das Globals.Factory-Objekt an diesen Parameter.

Rückgabewert

Typ: Microsoft.Office.Tools.Word.Document
Ein Hostelement, das die Funktionalität des aktuellen Microsoft.Office.Interop.Word.Document-Objekts erweitert.

Hinweis zur Verwendung

In Visual Basic und C# können Sie diese Methode als Instanzenmethode für ein beliebiges Objekt vom Typ _Document aufrufen. Bei Verwendung der Syntax für Instanzenmethoden lassen Sie den ersten Parameter aus. Weitere Informationen finden Sie unter Erweiterungsmethoden (Visual Basic) und Erweiterungsmethoden (C#-Programmierhandbuch).

Hinweise

In einer Anpassung auf Dokumentebene können Sie diese Methode aufrufen, um ein Microsoft.Office.Tools.Word.Document-Hostelement abzurufen, das sich in der aktuellen Anpassung befindet. Wenn das Microsoft.Office.Interop.Word.Document-Objekt, für das Sie diese Methode aufrufen, nicht das zugrunde liegende Objekt eines Microsoft.Office.Tools.Word.Document-Hostelements in der aktuellen Anpassung ist, gibt diese Methode nullNULL-Verweis (Nothing in Visual Basic) zurück.

Diese Methode wird zur Abwärtskompatibilität mit Office-Projekten bereitgestellt, für die das Ziel von .NET Framework 3.5 auf .NET Framework 4 umgestellt wird. In neuen Projekten, die auf den .NET Framework 4 abzielen, sollten Sie die GetVstoObject-Methode aufrufen, die vom Globals.Factory-Objekt im Projekt bereitgestellt wird. Weitere Informationen finden Sie unter Abrufen von erweiterten Objekten aus systemeigenen Office-Objekten in Anpassungen auf Dokumentebene.

Tipp

Der document-Parameter ist vom Typ Microsoft.Office.Interop.Word._Document, bei dem es sich um die übergeordnete Schnittstelle von Microsoft.Office.Interop.Word.Document handelt. Deshalb erweitert diese Methode beide Typen: Microsoft.Office.Interop.Word._Document und Microsoft.Office.Interop.Word.Document. Normalerweise wird mithilfe von Microsoft.Office.Interop.Word.Document auf ein Word-Dokument verwiesen.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.