Dokumenthostelement

Aktualisiert: Juli 2008

Das Document-Hostelement stellt ein Word-Dokument dar, das Ereignisse verfügbar macht und als Container für Hoststeuerelemente und Windows Forms-Steuerelemente dient. Das Document-Hostelement stellt auch dieselben Eigenschaften, Methoden und Ereignisse wie die Microsoft.Office.Interop.Word.Document-Klasse in der primären Interopassembly für Word bereit.

In Projekten auf Dokumentebene gibt es ein Document-Hostelement, das das Dokument im Projekt darstellt. Ab Visual Studio 2008 Service Pack 1 (SP1) können Sie Document-Hostelemente zur Laufzeit auch mit dem Add-In auf Anwendungsebene für Word 2007 generieren.

Grundlegendes zum Dokumenthostelement in Projekten auf Dokumentebene

Um programmgesteuert auf das Dokument in Ihrem Projekt zuzugreifen, verwenden Sie die ThisDocument-Klasse. Wenn Sie ein Projekt auf Dokumentebene erstellen, generiert Visual Studio Tools for Office die ThisDocument-Klasse, die als Kommunikationsverbindung zwischen Word und dem Anpassungscode dient. Die ThisDocument-Klasse wird von der Document-Hostelementklasse abgeleitet. Visual Studio Tools for Office instanziiert automatisch die ThisDocument-Klasse, wenn das Dokument zur Laufzeit geöffnet wird. Instantiieren Sie die Document-Klasse nicht direkt in Ihrem Code.

Über die ThisDocument-Klasse erhalten Sie Zugriff auf Member des Document-Hostelements, um grundlegende Aufgaben in der Anpassung auszuführen, z. B. das Ausführen von Code, wenn das Dokument geöffnet bzw. geschlossen wird. Sie können mit der Klasse dem Dokument auch Steuerelemente und Smarttags hinzufügen. Sie können Steuerelemente an Daten binden, Informationen vom Benutzer sammeln und auf Benutzeraktionen reagieren, indem Sie verschiedene Gruppen von Steuerelementen kombinieren und Code schreiben. Weitere Informationen finden Sie unter Programmieren von Anpassungen auf Dokumentebene.

Die ThisDocument-Klasse bietet einen Ausgangspunkt, um den Code im Projekt zu schreiben. Da die Klasse dieselben Eigenschaften, Methoden und Ereignisse wie die Microsoft.Office.Interop.Word.Document-Klasse in der primären Interopassembly für Word bereitstellt, können Sie auch mit ThisDocument auf das Word-Objektmodell zugreifen. Weitere Informationen finden Sie unter Übersicht über das Word-Objektmodell.

Einschränkungen des Dokumenthostelements

Ein Projekt auf Dokumentebene kann nur ein Document-Hostelement enthalten. Sie können dem Projekt zur Entwurfszeit keine neuen Document-Hostelemente hinzufügen, und Sie können zur Laufzeit von einer Anpassung auf Dokumentebene keine neuen Document-Hostelemente programmgesteuert erstellen.

Wenn Sie zur Laufzeit ein neues Word-Dokument erstellen, ist es vom Typ Microsoft.Office.Interop.Word.Document. Da es kein Hostelement ist, kann es keine Hoststeuerelemente bzw. Windows Forms-Steuerelemente enthalten. Weitere Informationen über das Erstellen von Dokumenten zur Laufzeit finden Sie unter Gewusst wie: Erstellen neuer Dokumente.

Grundlegendes zu Dokumenthostelementen in Projekten auf Anwendungsebene

Ab SP1 können Sie für jedes Dokument, das in Word geöffnet ist, ein Document-Hostelement zur Laufzeit erstellen. Sie können das Document-Hostelement verwenden, um Steuerelemente und Smarttags dem zugeordneten Dokument hinzuzufügen.

Zum Generieren eines Document-Hostelements verwenden Sie die GetVstoObject-Methode eines beliebigen Microsoft.Office.Interop.Word.Document-Objekts. Weitere Informationen hierzu finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

Siehe auch

Konzepte

Übersicht über Hostelemente und Hoststeuerelemente

Übersicht über das Word-Objektmodell

Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen

Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit

Weitere Ressourcen

Word-Hoststeuerelemente

Excel-Hoststeuerelemente

Änderungsverlauf