Freigeben über


Arbeitsblatthostelement

Das Worksheet -Hostelement ist ein Typ, der den Worksheet -Typ aus der primären Interopassembly für Excel erweitert. Das Worksheet -Hostelement stellt die gleichen Eigenschaften, Methoden und Ereignisse wie ein Worksheet -Objekt bereit, es macht jedoch auch zusätzliche Ereignisse verfügbar und fungiert als Container für Hoststeuerelemente und Windows Forms-Steuerelemente.

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 können Sie Worksheet -Hostelemente einem Projekt zur Entwurfszeit hinzufügen. In VSTO-Add-In-Projekten können Sie Worksheet -Hostelemente zur Laufzeit generieren.

Grundlegendes zu Arbeitsblatthostelementen in Projekten auf Dokumentebene

Wenn Sie ein Projekt auf Dokumentebene für Excel erstellen, werden von Visual Studio automatisch drei Worksheet -Hostelemente im Projekt erstellt. Die Standardnamen der Arbeitsblätter sind Sheet1, Sheet2und Sheet3. Wenn Sie ein Projekt auf Basis einer vorhandenen Arbeitsmappe erstellen, wird die Anzahl von Hostelementen von der Anzahl von Arbeitsblättern in der Arbeitsmappe bestimmt.

Über diese Arbeitsblattklassen erhalten Sie Zugriff auf Member des Worksheet -Hostelements, um grundlegende Aufgaben in Ihrer Anpassung auszuführen, beispielsweise das Ändern des Inhalts eines Arbeitsblatts. Sie können diese Klassen auch verwenden, um den Arbeitsblättern Steuerelemente hinzuzufügen. Sie können Steuerelemente an Daten binden, Benutzerinformationen abfragen und auf Benutzeraktionen reagieren, indem Sie verschiedene Gruppen von Steuerelementen kombinieren und Code schreiben. Weitere Informationen finden Sie unter Anpassungen auf Dokumentebene auf Programmebene.

Die Arbeitsblattklassen stellen einen Ausgangspunkt bereit, an dem Sie mit dem Schreiben von Code im Projekt beginnen können. Da die Klassen die gleichen Eigenschaften, Methoden und Ereignisse wie das Worksheet -Objekt in der primären Interopassembly für Excel bereitstellen, können Sie über diese Klassen auch auf das Objektmodell von Excel zugreifen. Weitere Informationen finden Sie in der Excel-Objektmodellübersicht.

In Projekten auf Dokumentebene können Sie dem Projekt zur Entwurfszeit weitere Worksheet -Hostelemente hinzufügen, indem Sie der Arbeitsmappe im Designer ein neues Arbeitsblatt hinzufügen.

Umbenennen von Arbeitsblättern

In einem Projekt auf Dokumentebene können die Arbeitsblätter im Visual Studio-Designer umbenannt werden, wodurch jedoch nur der Anzeigename des Arbeitsblatts geändert wird. Der Name im Programm ist weiterhin der Standardname des Arbeitsblatts. Wenn Sie das Arbeitsblatt im Fenster Eigenschaften umbenennen, wird nur der Name im Programm geändert.

Einschränkungen des Arbeitsblatthostelements in Projekten auf Dokumentebene

In einem Projekt auf Dokumentebene können Sie zur Laufzeit keine neuen Worksheet -Hostelemente erstellen. Wenn Sie zur Laufzeit ein neues Excel-Arbeitsblatt erstellen, hat es den Typ Worksheet. Da es kein Hostelement ist, kann es keine Hoststeuerelemente bzw. Windows Forms-Steuerelemente enthalten. Weitere Informationen zum Erstellen von Dokumenten zur Laufzeit finden Sie unter How to: Programmatically add new worksheets to workbooks.

Grundlegendes zu Arbeitsblatthostelementen in VSTO-Add-In-Projekten

In Projekten auf Anwendungsebene können Sie für jedes Arbeitsblatt, das in Excel geöffnet ist, zur Laufzeit ein Worksheet -Hostelement erstellen. Sie können das Worksheet -Hostelement verwenden, um dem zugeordneten Arbeitsblatt Steuerelemente hinzuzufügen, oder um Ereignisse zu behandeln, die für Worksheet -Objekte nicht verfügbar sind.

Verwenden Sie zum Generieren eines Worksheet-Hostelements die GetVstoObject-Methode. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in VSTO-Add-Ins zur Laufzeit.