Arbeitsmappenhostelement

Artikel
08/10/2011

Das Workbook-Hostelement ist ein Typ, der den Microsoft.Office.Interop.Excel.Workbook-Typ der primären Interopassembly für Excel erweitert. Das Workbook-Hostelement stellt die gleichen Eigenschaften, Methoden und Ereignisse wie ein Microsoft.Office.Interop.Excel.Workbook-Objekt bereit, es stellt aber auch zusätzliche Funktionen bereit.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und auf Anwendungsebene für Excel 2007 und Excel 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

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

Grundlegendes zum Arbeitsmappenhostelement in Projekten auf Dokumentebene

Verwenden Sie die ThisWorkbook-Klasse, um auf die Arbeitsmappe im Projekt zuzugreifen. Über die ThisWorkbook-Klasse erhalten Sie Zugriff auf Member des Workbook-Hostelements, um grundlegende Aufgaben in der Anpassung auszuführen, z. B. das Ausführen von Code, wenn die Arbeitsmappe geöffnet bzw. geschlossen wird. Weitere Informationen finden Sie unter Programmieren von Anpassungen auf Dokumentebene.

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

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

Einschränkungen des Arbeitsmappenhostelements in Projekten auf Dokumentebene

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

Wenn Sie zur Laufzeit eine neue Excel-Arbeitsmappe erstellen, ist sie vom Typ Microsoft.Office.Interop.Excel.Workbook. Da es kein Hostelement ist, kann es keine Hoststeuerelemente bzw. Windows Forms-Steuerelemente enthalten. Weitere Informationen zum Erstellen von Arbeitsmappen zur Laufzeit finden Sie unter Gewusst wie: Erstellen neuer Arbeitsmappen.

Das Workbook-Hostelement dient nicht als Container für Hoststeuerelemente. Deshalb können Sie der Arbeitsmappe keine sichtbaren Steuerelemente hinzufügen. Sie haben jedoch die Möglichkeit, Komponenten wie ein DataSet hinzuzufügen, sodass die Komponenten für alle Arbeitsblätter freigegeben sind. In einem Projekt auf Dokumentebene finden Sie Komponenten, die für die Arbeitsmappe verfügbar sind, in der Toolbox auf den Registerkarten Komponenten, Daten und Alle Windows Forms.

Tipp

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

Grundlegendes zu Arbeitsmappenhostelementen in Projekten auf Anwendungsebene

In Projekten auf Anwendungsebene können Sie für jede Arbeitsmappe, die in Excel geöffnet ist, zur Laufzeit ein Workbook-Hostelement erstellen. Verwenden Sie zum Generieren eines Workbook-Hostelements die GetVstoObject-Methode. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.