Freigeben über

Arbeitsmappen-Hostelement

Das Workbook Host-Element ist ein Typ, der den Workbook Typ aus der primären Interop-Assembly für Excel erweitert. Das Workbook Hostelement stellt alle gleichen Eigenschaften, Methoden und Ereignisse wie das Objekt Workbook bereit, bietet aber auch zusätzliche Funktionen.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte für Excel. Weitere Informationen finden Sie unter Funktionen verfügbar nach Office-Anwendung und Projekttyp.

In Projekten auf Dokumentebene gibt es ein Standardhostelement Workbook , das die Arbeitsmappe in Ihrem Projekt darstellt. In VSTO-Add-In-Projekten können Sie Workbook Hostelemente zur Laufzeit generieren.

Grundlegendes über das Arbeitsmappenhostelement in Projekten auf Ebene des Dokuments

Verwenden Sie die ThisWorkbook Klasse, um auf die Arbeitsmappe in Ihrem Projekt zuzugreifen. Die ThisWorkbook Klasse bietet Ihnen die Möglichkeit, auf Mitglieder des Workbook Host-Elements zuzugreifen, um grundlegende Aufgaben bei Ihren Anpassungen auszuführen, wie z. B. das Ausführen von Code, wenn die Arbeitsmappe geöffnet oder geschlossen wird. Weitere Informationen finden Sie unter Dokumentenanpassungen auf Programmebene.

Die ThisWorkbook 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 Workbook Objekt in der primären Interopassembly für Excel bereitstellt, können Sie auch für den Zugriff auf das Objektmodell von Excel verwenden ThisWorkbook . Weitere Informationen finden Sie in der Excel-Objektmodellübersicht.

Doppelklicken Sie im Projektmappen-Explorer auf das Projektelement "ThisWorkbook", um den Arbeitsmappen-Designer anzuzeigen und die Eigenschaften und Ereignisse der Arbeitsmappe im Eigenschaftenfenster anzuzeigen.

Einschränkungen des Arbeitsmappenhostelements in Projekten auf Dokumentebene

Ein Projekt auf Dokumentebene kann nur ein Workbook Hostelement (d. a. die ThisWorkbook Klasse) enthalten. Sie können Ihrem Projekt zur Entwurfszeit keine neuen Workbook Hostelemente hinzufügen, und Sie können zur Laufzeit keine neuen Workbook Hostelemente aus einer Anpassung auf Dokumentebene erstellen.

Wenn Sie zur Laufzeit eine neue Excel-Arbeitsmappe erstellen, ist sie vom Typ Workbook. Da es kein Hostelement ist, kann es keine Hoststeuerelemente oder Windows Forms-Steuerelemente enthalten. Weitere Informationen zum Erstellen von Arbeitsmappen während der Ausführung finden Sie unter How to: Programmatically create new workbooks.

Das Workbook Hostelement fungiert nicht als Container für Host-Steuerelemente. Daher können Sie der Arbeitsmappe keine sichtbaren Steuerelemente hinzufügen, aber Sie können Komponenten hinzufügen, z. B. ein DataSet, damit die Komponenten von allen Arbeitsblättern gemeinsam verwendet werden können. In einem Projekt auf Dokumentebene finden Sie Komponenten, die für die Arbeitsmappe verfügbar sind, auf der Registerkarte " Komponente ", auf der Registerkarte " Daten " und auf der Registerkarte "Alle Windows Forms " der Toolbox.

Hinweis

Die Office-Entwicklungstools in Visual Studio unterstützen keine freigegebenen Arbeitsmappen.

Verstehen von Arbeitsmappen-Hostelementen in VSTO-Add-In-Projekten

In VSTO-Add-In-Projekten können Sie zur Laufzeit ein Workbook Hostelement für eine in Excel geöffnete Arbeitsmappe erstellen. Verwenden Sie die Methode Workbook, um ein Hostelement GetVstoObject zu generieren. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in VSTO-Add-Ins zur Laufzeit.

Verwandte Inhalte

  • Last updated on