Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Document Hosteintrag ist ein Typ, der den Document Typ aus der primären Interop-Assembly für Word erweitert. Das Document Hostelement stellt alle gleichen Eigenschaften, Methoden und Ereignisse als Objekt Document bereit, stellt aber auch zusätzliche Ereignisse bereit und fungiert als Container für Hoststeuerelemente und Windows Forms-Steuerelemente.
Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte für Word. Weitere Informationen finden Sie unter Funktionen verfügbar nach Office-Anwendung und Projekttyp.
In Projekten auf Dokumentebene gibt es ein Standardhostelement Document , das das Dokument in Ihrem Projekt darstellt. In VSTO-Add-In-Projekten können Sie Document Hostelemente zur Laufzeit generieren.
Grundlegendes zum Dokumenthostelement in Projekten auf Dokumentebene
Verwenden Sie die ThisDocument Klasse, um auf das Dokument in Ihrem Projekt zuzugreifen. Wenn Sie ein Projekt auf Dokumentebene erstellen, generiert Visual Studio die ThisDocument Klasse als Kommunikationsverbindung zwischen Word und Ihrem Anpassungscode. Die ThisDocument Klasse bietet Ihnen Zugriff auf Member des Document Host-Element, um grundlegende Aufgaben in Ihrer Anpassung auszuführen, z. B. Code auszuführen, wenn das Dokument geöffnet oder geschlossen wird. Sie können die Klasse auch verwenden, um dem Dokument Steuerelemente hinzuzufügen. Durch die Kombination verschiedener Steuerelemente und schreiben von Code können Sie die Steuerelemente an Daten binden, Informationen vom Benutzer sammeln und auf Benutzeraktionen reagieren. Weitere Informationen finden Sie unter Dokumentenanpassungen auf Programmebene.
Die ThisDocument Klasse stellt einen Speicherort bereit, an dem Sie mit dem Schreiben von Code in Ihrem Projekt beginnen können. Da die Klasse alle gleichen Eigenschaften, Methoden und Ereignisse wie das Document Objekt in der primären Interopassembly für Word bereitstellt, können Sie auch für den Zugriff auf das Objektmodell von Word verwenden ThisDocument . Weitere Informationen finden Sie in der Übersicht über das Word-Objektmodell.
Einschränkungen des Dokumenthostelements in Projekten auf Dokumentebene
Ein Projekt auf Dokumentebene kann nur ein Document Hostelement (d. a. die ThisDocument Klasse) enthalten. Sie können Ihrem Projekt zur Entwurfszeit keine neuen Document Hostelemente hinzufügen, und Sie können zur Laufzeit keine neuen Document Hostelemente aus einer Anpassung auf Dokumentebene erstellen.
Wenn Sie zur Laufzeit ein neues Word-Dokument erstellen, ist es vom Typ Document. Da es kein Hostelement ist, kann es keine Hoststeuerelemente oder Windows Forms-Steuerelemente enthalten. Weitere Informationen zum Erstellen von Dokumenten zur Laufzeit finden Sie unter Wie: Neue Dokumente programmatisch erstellen.
Grundlegendes zu Dokumenthostelementen in Projekten auf Anwendungsebene
In VSTO-Add-In-Projekten können Sie zur Laufzeit ein Document Hostelement für jedes Dokument generieren, das in Word geöffnet ist. Mit dem Document-Hostelement können Sie dem zugeordneten Dokument Steuerelemente hinzufügen oder Ereignisse behandeln, die bei Document-Objekten nicht verfügbar sind.
Verwenden Sie die Methode Document, um ein Hostelement GetVstoObject zu generieren. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in VSTO-Add-Ins zur Laufzeit.