Freigeben über


Arbeitsblatthostelement

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 Worksheet-Hostelement ist ein Arbeitsblatt, das Ereignisse verfügbar macht und als Container für Hoststeuerelemente und Windows Forms-Steuerelemente dient.

Wenn Sie eine neue Anpassung auf Dokumentebene für Microsoft Office Excel erstellen, werden von Visual Studio Tools for Office automatisch drei Worksheet-Hostelemente im Projekt erstellt. Die Standardnamen der Arbeitsblätter sind Sheet1, Sheet2 und Sheet3. Wenn Sie eine Anwendung auf der Grundlage einer vorhandenen Arbeitsmappe erstellen, wird die Anzahl der Hostelemente von der Anzahl der Arbeitsblätter in der Arbeitsmappe bestimmt.

Grundlagen von Arbeitsblatt-Hostelementen

Sie können einem Worksheet-Hostelement Windows Form-Steuerelemente und Hoststeuerelemente auf dieselbe Weise hinzufügen, wie Sie einem Windows Form Windows Forms-Steuerelemente hinzufügen.

Sie können in einem Projekt auf Dokumentebene dem Projekt zur Entwurfszeit zusätzliche Worksheet-Hostelemente hinzufügen. Microsoft.Office.Tools.Excel.Worksheet-Hostelemente werden beim programmgesteuerten Hinzufügen eines Arbeitsblatts jedoch nicht automatisch erstellt. Beim Hinzufügen eines Arbeitsblatts zur Laufzeit in einem Projekt auf Dokumentebene gehört es zum Typ Microsoft.Office.Interop.Excel.Worksheet und kann keine Hoststeuerelemente oder Windows Forms-Steuerelemente enthalten.

Ab Visual Studio 2008 Service Pack 1 (SP1) können Arbeitsblätter zur Laufzeit in einem Add-In auf Anwendungsebene hinzugefügt werden. Daraufhin kann die GetVstoObject-Methode eines Microsoft.Office.Interop.Excel.Worksheet-Objekts aufgerufen werden, um ein Worksheet-Hostelement abzurufen. Weitere Informationen hierzu finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

In Excel-Projekten ist das Arbeitsblatt das Hauptmittel für die Benutzerinteraktion. Sie können Steuerelemente an Daten binden, Informationen des Benutzers sammeln und auf Benutzeraktionen reagieren, indem Sie verschiedene Gruppen von Steuerelementen kombinieren und Code schreiben.

Umbenennen des Arbeitsblatts

In einer Anpassung auf Dokumentebene, kann das Arbeitsblatt im Visual Studio-Designer umbenannt werden. Damit wird jedoch nur der Anzeigename des Arbeitsblatts geändert. Der Name im Programm ist immer noch der Standardname des Arbeitsblatts. Wenn Sie das Arbeitsblatt im Fenster Eigenschaften umbenennen, wird nur der Name im Programm geändert.

Ereignisse

Die folgenden Ereignisse sind für das Worksheet-Hostelement verfügbar:

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

Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit

Übersicht über Hostelemente und Hoststeuerelemente

Arbeitsmappenhostelement

Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen

Weitere Ressourcen

Steuerelemente für Office-Dokumente

Excel-Hoststeuerelemente

Änderungsprotokoll

Date

Versionsgeschichte

Grund

Juli 2008

Informationen über die Verwendung von Arbeitsblatt-Hostelementen in Add-Ins auf Anwendungsebene hinzugefügt.

SP1-Featureänderung.