Freigeben über

Arbeitsblatthostitem

Das Worksheet Host-Element ist ein Typ, der den Worksheet Typ aus der primären Interop-Assembly für Excel erweitert. Das Worksheet Hostelement stellt alle gleichen Eigenschaften, Methoden und Ereignisse als Objekt Worksheet bereit, stellt aber auch zusätzliche Ereignisse bereit 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 Funktionen verfügbar nach Office-Anwendung und Projekttyp.

Bei dokumentbasierten Projekten können Sie zur Entwurfszeit Hostelemente zu Ihrem Projekt hinzufügen Worksheet. In VSTO-Add-In-Projekten können Sie Worksheet Hostelemente zur Laufzeit generieren.

Verstehen von Arbeitsblatthostelementen in dokumentenbasierten Projekten

Wenn Sie ein Projekt auf Dokumentebene für Excel erstellen, erstellt Visual Studio automatisch drei Worksheet Host-Elemente im Projekt. Die Standardnamen der Arbeitsblätter sind Sheet1, Sheet2und Sheet3. Wenn Sie ein Projekt auf Grundlage einer vorhandenen Arbeitsmappe erstellen, richtet sich die Anzahl der Hostelemente nach der Anzahl der Arbeitsblätter in der Arbeitsmappe.

Diese Arbeitsblattklassen ermöglichen Ihnen den Zugriff auf Mitglieder des Worksheet Hostelements, um grundlegende Aufgaben bei Ihrer Anpassung auszuführen, z. B. das Ändern des Inhalts eines Arbeitsblatts. Sie können diese Klassen auch verwenden, um Arbeitsblättern Steuerelemente hinzuzufügen. Durch die Kombination verschiedener Steuerelemente und schreiben von Code können Sie die Steuerelemente an Daten binden, Informationen vom Benutzer sammeln und auf Benutzeraktionen reagieren. Weitere Informationen finden Sie unter Dokumentenanpassungen auf Programmebene.

Die Arbeitsblattklassen stellen einen Speicherort bereit, an dem Sie mit dem Schreiben von Code in Ihrem Projekt beginnen können. Da die Klasse alle gleichen Eigenschaften, Methoden und Ereignisse wie das Worksheet Objekt in der primären Interopassembly für Excel bereitstellt, können Sie diese Klassen auch verwenden, um auf das Objektmodell von Excel zuzugreifen. Weitere Informationen finden Sie in der Excel-Objektmodellübersicht.

In Projekten auf Dokumentebene können Sie dem Projekt während der Entwurfszeit zusätzliche Worksheet Hostelemente hinzufügen, indem Sie im Designer ein neues Arbeitsblatt zur Arbeitsmappe hinzufügen.

Umbenennen von Arbeitsblättern

In einem Projekt auf Dokumentebene können Sie die Arbeitsblätter im Visual Studio-Designer umbenennen, dies ändert jedoch nur den Anzeigenamen des Arbeitsblatts. Der programmgesteuerte Name ist weiterhin der Standardname des Arbeitsblatts. Wenn Sie das Arbeitsblatt im Eigenschaftenfenster umbenennen, wird nur der programmgesteuerte Name geändert.

Einschränkungen des Arbeitsblatthostelements in Projekten auf Dokumentebene

Sie können zur Laufzeit in einem Dokumentebenenprojekt keine neuen Worksheet Hostelemente erstellen. Wenn Sie zur Laufzeit ein neues Excel-Arbeitsblatt erstellen, ist es vom Typ Worksheet. Da es kein Hostelement ist, kann es keine Hoststeuerelemente oder Windows Forms-Steuerelemente enthalten. Weitere Informationen zum Erstellen von Dokumenten zur Laufzeit finden Sie unter Vorgehensweise: Programmgesteuertes Hinzufügen neuer Arbeitsblätter zu Arbeitsmappen.

Verständnis von Arbeitsblatt-Hostelementen in VSTO-Add-In-Projekten

In Anwendungsebene-Projekten können Sie zur Laufzeit ein Host-Element für jedes Arbeitsblatt generieren, das in Excel geöffnet ist. Mit dem Worksheet Hostelement können Sie Steuerelemente zu dem zugeordneten Arbeitsblatt hinzufügen oder Ereignisse behandeln, die bei Worksheet Objekten nicht verfügbar sind.

Verwenden Sie die Methode Worksheet, um ein Hostelement GetVstoObject zu generieren. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in VSTO-Add-Ins zur Laufzeit.

Verwandte Inhalte

  • Last updated on