Arbeitsmappenhostelement

Aktualisiert: Juli 2008

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekte auf Dokumentebene Excel 2007 Excel 2003 Projekte auf Anwendungsebene Excel 2007 Weitere Informationen finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Das Workbook-Hostelement ist ein Arbeitsmappenobjekt, das Ereignisse verfügbar macht und als Container für Komponenten dient.

Wenn Sie eine Anpassung auf Dokumentebene für Microsoft Office Excel erstellen, wird von Visual Studio Tools for Office automatisch ein Workbook-Hostelement im Projekt erstellt. Verweisen Sie auf das Workbook mit ThisWorkbook.

Ab Visual Studio 2008 Service Pack 1 (SP1) können Sie ein Workbook-Hostelement in einem Add-In auf Anwendungsebene abrufen, indem Sie die GetVstoObject-Methode eines Microsoft.Office.Interop.Excel.Workbook-Objekts aufrufen. Weitere Informationen hierzu finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

Grundlegendes zu Arbeitsmappen-Hostelementen

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.

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

Hinweis:
Visual Studio Tools for Office unterstützt keine freigegebenen Arbeitsmappen.

Ereignisse

Für das Workbook-Hostelement sind folgende Ereignisse verfügbar:

• ActivateEvent

• AddinInstall

• AddinUninstall

• AfterXmlExport

• AfterXmlImport

• BeforeClose

• BeforePrint

• BeforeSave

• BeforeXmlExport

• BeforeXmlImport

• BindingContextChanged

• Deactivate

• Disposed

• New

• NewSheet

• Open

• PivotTableCloseConnection

• PivotTableOpenConnection

• RowsetComplete

• SheetActivate

• SheetBeforeDoubleClick

• SheetBeforeRightClick

• SheetCalculate

• SheetChange

• SheetDeactivate

• SheetFollowHyperlink

• SheetPivotTableUpdate

• SheetSelectionChange

• Shutdown

• Startup

• SyncEvent

• WindowActivate

• WindowDeactivate

• WindowResize

Siehe auch

Aufgaben

Beispiel für dynamische Add-In-Steuerelemente in Excel

Konzepte

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

Übersicht über Hostelemente und Hoststeuerelemente

Arbeitsblatthostelement

Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen

Weitere Ressourcen

Excel-Hoststeuerelemente

Änderungsprotokoll

Date	Versionsgeschichte	Grund
Juli 2008	Informationen zum Verwenden von Arbeitsmappen-Hostelementen in Add-Ins auf Anwendungsebene hinzugefügt.	SP1-Featureänderung.