Freigeben über

Arbeitsmappenhostelement

  • Artikel

Das Workbook -Hostelement ist ein Typ, der den Workbook -Typ aus der primären Interopassembly für Excel erweitert. Das Workbook -Hostelement stellt die gleichen Eigenschaften, Methoden und Ereignisse wie ein Workbook -Objekt bereit, bietet jedoch 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 features available by Office-App lication and project type.

In Projekten auf Dokumentebene gibt es ein Workbook -Standardhostelement, das die Arbeitsmappe im Projekt darstellt. In VSTO-Add-In-Projekten 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 Anpassungen auf Dokumentebene auf Programmebene.

Die ThisWorkbook -Klasse stellt einen Ausgangspunkt bereit, an dem Sie mit dem Schreiben von Code im Projekt beginnen können. Da die Klasse die gleichen Eigenschaften, Methoden und Ereignisse wie das 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 in der Excel-Objektmodellübersicht.

Doppelklicken Sie im Projektmappen-Explorer auf das ThisWorkbook -Projektelement, um den Arbeitsmappen-Designer und 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, hat sie den Typ 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 How to: Programmatically create new workbooks.

Das Workbook Hostelement dient nicht als Container für Hoststeuerelemente. Daher können Sie der Arbeitsmappe keine sichtbaren Steuerelemente hinzufügen. Sie können jedoch Komponenten wie DataSethinzufügen, sodass die Komponenten von allen Arbeitsblättern gemeinsam genutzt werden können. In einem Projekt auf Dokumentebene befinden sich die für die Arbeitsmappe verfügbare Komponenten auf den Registerkarten Komponente , Daten und Alle Windows Forms der Toolbox.

Hinweis

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

Grundlegendes zu Arbeitsmappenhostelementen in VSTO-Add-In-Projekten

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

Zugehöriger Inhalt