Arbeitsblatthostelement

Artikel
08/10/2011

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

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und auf Anwendungsebene für Excel 2007 und Excel 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In Projekten auf Dokumentebene können Sie dem Projekt Worksheet-Hostelemente zur Entwurfszeit hinzufügen. In Projekten auf Anwendungsebene 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, Sheet2 und Sheet3. Wenn Sie ein Projekt auf der Grundlage einer vorhandenen Arbeitsmappe erstellen, wird die Anzahl der Hostelemente von der Anzahl der Arbeitsblätter in der Arbeitsmappe bestimmt.

Über diese Arbeitsblattklassen erhalten Sie Zugriff auf Member des Worksheet-Hostelements, um grundlegende Aufgaben in der Anpassung auszuführen, z. B. das Ändern des Inhalts eines Arbeitsblatts. Sie können mit diesen Klassen Arbeitsblättern auch Steuerelemente und Smarttags hinzufügen. Sie können Steuerelemente an Daten binden, Informationen vom Benutzer sammeln und auf Benutzeraktionen reagieren, indem Sie verschiedene Gruppen von Steuerelementen kombinieren und Code schreiben. Weitere Informationen finden Sie unter Programmieren von Anpassungen auf Dokumentebene.

Tipp

Smarttags sind in Excel 2010 und Word 2010 veraltet. Weitere Informationen finden Sie unter Übersicht über Smarttags.

Die Arbeitsblattklassen bieten einen Ausgangspunkt, um den Code im Projekt zu schreiben. Da die Klasse die gleichen Eigenschaften, Methoden und Ereignisse wie das Microsoft.Office.Interop.Excel.Worksheet-Objekt in der primären Interopassembly für Excel bereitstellt, können Sie mit diesen Klassen auch auf das Excel-Objektmodell zugreifen. Weitere Informationen finden Sie unter Übersicht über das Excel-Objektmodell.

In Projekten auf Dokumentebene können Sie dem Projekt zur Entwurfszeit zusätzliche Worksheet-Hostelemente durch Hinzufügen eines neuen Arbeitsblatts zur Arbeitsmappe im Designer hinzufügen.

Umbenennen von Arbeitsblättern

In einem Projekt auf Dokumentebene, können die Arbeitsblätter 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.

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, ist es vom Typ Microsoft.Office.Interop.Excel.Worksheet. Da es kein Hostelement ist, kann es keine Hoststeuerelemente bzw. Windows Forms-Steuerelemente enthalten. Weitere Informationen über das Erstellen von Dokumenten zur Laufzeit finden Sie unter Gewusst wie: Hinzufügen neuer Arbeitsblätter zu Arbeitsmappen.

Grundlegendes zu Arbeitsblatthostelementen in Projekten auf Anwendungsebene

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 mit dem Worksheet-Hostelement dem zugeordneten Arbeitsblatt Steuerelemente und Smarttags hinzufügen oder Ereignisse behandeln, die in Microsoft.Office.Interop.Excel.Worksheet-Objekten 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 Add-Ins auf Anwendungsebene zur Laufzeit.