Worksheet-Schnittstelle

Artikel
08/10/2011

Stellt ein Arbeitsblatt in Excel-Projekten dar, die mit den Office-Entwicklungstools in Visual Studio erstellt wurden.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
<GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")> _
Public Interface Worksheet _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")]
public interface Worksheet : IBindableComponent, 
    IComponent, IDisposable, ISupportInitialize

Der Worksheet-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	_CodeName	Infrastruktur.
	_DisplayRightToLeft	Infrastruktur.
	Application	Diese Eigenschaft ruft eine Microsoft.Office.Interop.Excel.Application ab, die die Anwendung Microsoft Office Excel darstellt.
	AutoFilter	Ruft ein Microsoft.Office.Interop.Excel.AutoFilter-Element ab, das Informationen zu gefilterten Listen auf dem Arbeitsblatt bereitstellt, wenn das Filtern aktiviert ist.Ruft nullNULL-Verweis (Nothing in Visual Basic) ab, wenn das Filtern deaktiviert ist.
	AutoFilterMode	Ruft einen Wert ab, der angibt, ob das Filtern auf dem Arbeitsblatt aktiviert ist (d. h., ob die Dropdownpfeile des Filters gerade angezeigt werden), oder ruft diesen Wert ab.
	BindingContext	Ruft die Auflistung von CurrencyManager-Objekten für die IBindableComponent ab oder legt diese fest. (Von IBindableComponent geerbt.)
	Cells	Ruft ein Range-Objekt ab, das alle Zellen im Arbeitsblatt darstellt (und nicht nur die derzeit verwendeten Zellen).
	CircularReference	Ruft ein Range-Objekt ab, das den Bereich darstellt, der den ersten Zirkelverweis auf dem Arbeitsblatt enthält, oder ruft nullNULL-Verweis (Nothing in Visual Basic) ab, wenn kein Zirkelverweis auf dem Arbeitsblatt vorhanden ist.
	CodeName	Infrastruktur.
	Columns	Ruft ein Range-Objekt ab, das eine oder alle Spalten im Arbeitsblatt darstellt.
	Comments	Ruft eine Microsoft.Office.Interop.Excel.Comments-Auflistung ab, die alle Kommentare für das Arbeitsblatt darstellt.
	ConsolidationFunction	Ruft den Funktionscode ab, der für die aktuelle Konsolidierung verwendet wird.
	ConsolidationOptions	Ruft ein Array von Konsolidierungsoptionen ab, das drei Elemente enthält.
	ConsolidationSources	Ruft ein Array von Zeichenfolgen ab, durch die die Quellarbeitsblätter und -bereiche für die aktuelle Konsolidierung des Arbeitsblatts benannt werden.
	Controls	Ruft die Auflistung von verwalteten Steuerelementen ab, die auf dem Arbeitsblatt enthalten sind.
	Creator	Ruft einen Wert ab, der die Anwendung angibt, in der das Arbeitsblatt erstellt wurde.
	CustomProperties	Ruft ein Microsoft.Office.Interop.Excel.CustomProperties-Objekt ab, das die einem Arbeitsblatt zugeordneten Bezeichnerinformationen darstellt.
	DataBindings	Ruft die Auflistung der Datenbindungsobjekte für diese IBindableComponent ab. (Von IBindableComponent geerbt.)
	DataHost	Infrastruktur.
	DefaultExtension	Ruft die Standarderweiterung für dieses Worksheet-Objekt ab.
	DisplayAutomaticPageBreaks	Infrastruktur.
	DisplayPageBreaks	Ruft einen Wert ab, der angibt, ob Seitenumbrüche (automatisch und manuell) im Arbeitsblatt angezeigt werden, oder legt diesen Wert fest.
	DisplayRightToLeft	Ruft einen Wert ab, der angibt, ob das Arbeitsblatt von rechts nach links statt von links nach rechts angezeigt wird, oder legt diesen Wert fest.
	EnableAutoFilter	Ruft einen Wert ab, der angibt, ob AutoFilter-Pfeile aktiviert sind, wenn der auf die Benutzeroberfläche begrenzte Schutz aktiviert ist, oder legt diesen Wert fest.
	EnableCalculation	Ruft einen Wert ab, der angibt, ob Microsoft Office Excel das Arbeitsblatt bei Bedarf automatisch neu berechnet, oder legt diesen Wert fest.
	EnableFormatConditionsCalculation	Ruft einen Wert ab, mit dem bestimmt wird, ob bedingte Formate automatisch auftreten, oder legt diesen Wert fest.
	EnableOutlining	Ruft einen Wert ab, der angibt, ob Gliederungssymbole aktiviert sind, wenn der auf die Benutzeroberfläche begrenzte Schutz aktiviert ist, oder legt diesen Wert fest.
	EnablePivotTable	Ruft einen Wert ab, der angibt, ob Steuerelemente und Aktionen der PivotTable aktiviert sind, wenn der auf die Benutzeroberfläche begrenzte Schutz aktiviert ist, oder legt diesen Wert fest.
	EnableSelection	Ruft einen Wert ab, der angibt, welche Zellen auf dem Blatt ausgewählt werden können, oder legt diesen Wert fest.
	Extension	Ruft eine benutzerdefinierte Erweiterung für dieses Worksheet-Objekt ab.
	FilterMode	Ruft einen Wert ab, der angibt, ob auf dem Arbeitsblatt aktiv Daten gefiltert werden.
	HostContext	Infrastruktur.
	HPageBreaks	Ruft eine Microsoft.Office.Interop.Excel.HPageBreaks-Auflistung ab, die die horizontalen Seitenumbrüche des Blatts darstellt.
	Hyperlinks	Ruft eine Microsoft.Office.Interop.Excel.Hyperlinks-Auflistung ab, die die Links für den Bereich oder das Arbeitsblatt darstellt.
	Index	Ruft die Indexnummer des Arbeitsblatts innerhalb der Auflistung der Arbeitsblätter ab.
	InnerObject	Ruft ein Microsoft.Office.Interop.Excel.Worksheet ab, das das zugrunde liegende systemeigene Objekt für das Worksheet darstellt.
	ItemProvider	Infrastruktur.
	ListObjects	Ruft eine Auflistung von Microsoft.Office.Interop.Excel.ListObject-Objekten im Arbeitsblatt ab.
	MailEnvelope	Ruft einen E-Mail-Header für das Arbeitsblatt ab.
	Name	Ruft den Namen des Arbeitsblatts ab oder legt ihn fest.
	Names	Ruft eine Microsoft.Office.Interop.Excel.Names-Auflistung ab, die alle arbeitsblattspezifischen Namen (mit dem Präfix "WorksheetName!" definierte Namen).
	Next	Ruft ein Microsoft.Office.Interop.Excel.Worksheet ab, das das nächste Blatt darstellt.
	OnCalculate	Infrastruktur.
	OnData	Infrastruktur.
	OnDoubleClick	Infrastruktur.
	OnEntry	Infrastruktur.
	OnSheetActivate	Infrastruktur.
	OnSheetDeactivate	Infrastruktur.
	Outline	Ruft ein Microsoft.Office.Interop.Excel.Outline-Element ab, das die Gliederung für das Arbeitsblatt darstellt.
	PageSetup	Ruft ein Microsoft.Office.Interop.Excel.PageSetup ab, das alle Einstellungen zum Einrichten der Seite für das Arbeitsblatt enthält.
	Parent	Ruft das übergeordnete Objekt für das Arbeitsblatt ab.
	Previous	Ruft ein Microsoft.Office.Interop.Excel.Worksheet ab, das das vorherige Blatt darstellt.
	PrintedCommentPages	Ruft die Anzahl der Kommentarseiten ab, die für das aktuelle Arbeitsblatt gedruckt werden.Diese Eigenschaft kann nur in Excel 2010-Projekten verwendet werden.
	ProtectContents	Ruft einen Wert ab, der angibt, ob der Inhalt des Arbeitsblatts (die einzelnen Zellen) geschützt ist.
	ProtectDrawingObjects	Ruft einen Wert ab, der angibt, ob Formen geschützt sind.
	Protection	Ruft ein Microsoft.Office.Interop.Excel.Protection-Objekt ab, das die Schutzoptionen des Arbeitsblatts darstellt.
	ProtectionMode	Ruft einen Wert ab, der angibt, ob der auf die Benutzeroberfläche begrenzte Schutz aktiviert ist.
	ProtectScenarios	Ruft einen Wert ab, der angibt, ob Arbeitsblattszenarien geschützt sind.
	QueryTables	Ruft die Microsoft.Office.Interop.Excel.QueryTables-Auflistung ab, die alle Abfragetabellen im Arbeitsblatt darstellt.
	Range	Ruft ein Microsoft.Office.Interop.Excel.Range-Objekt ab, das eine Zelle oder einen Zellenbereich darstellt.
	Rows	Ruft ein Range-Objekt ab, das eine oder alle Zeilen im Arbeitsblatt darstellt.
	Scripts	Ruft die Microsoft.Office.Core.Scripts-Auflistung mit Script-Objekten ab, die Skript- oder Codeblöcke im Arbeitsblatt darstellen, wenn dieses als Webseite gespeichert wird.
	ScrollArea	Ruft den Bereich, in dem ein Bildlauf zulässig ist, als Bereichsbezug im Format von A1 ab, oder legt diesen Bereich fest.
	Shapes	Ruft ein Microsoft.Office.Interop.Excel.Shapes-Objekt ab, das alle Formen im Arbeitsblatt darstellt.
	Site	Ruft die ISite ab, die IComponent zugeordnet ist, oder legt diese fest. (Von IComponent geerbt.)
	SmartTags	Ruft ein Microsoft.Office.Interop.Excel.SmartTags-Objekt ab, das die Auflistung von Smarttags für das Arbeitsblatt darstellt.
	Sort	Ruft die sortierten Werte im aktuellen Arbeitsblatt auf.
	StandardHeight	Ruft die Standardhöhe aller Zeilen im Arbeitsblatt in Punkt ab.
	StandardWidth	Ruft die Standardbreite aller Spalten im Arbeitsblatt ab oder legt diese fest.
	Tab	Ruft Microsoft.Office.Interop.Excel.Tab für das Arbeitsblatt ab.
	Tag	Ruft das Objekt ab, das Daten über das Arbeitsblatt enthält, oder legt dieses Objekt fest.
	TransitionExpEval	Ruft einen Wert ab, der angibt, ob Microsoft Office Excel für das Arbeitsblatt die Regeln für die Ausdrucksauswertung von Lotus 1-2-3 verwendet, oder legt diesen Wert fest.
	TransitionFormEntry	Ruft einen Wert ab, der angibt, ob Microsoft Office Excel für das Arbeitsblatt die Regeln für die Formeleingabe von Lotus 1-2-3 verwendet, oder legt diesen Wert fest.
	Type	Ruft den Arbeitsblatttyp ab.
	UsedRange	Ruft ein Microsoft.Office.Interop.Excel.Range-Objekt ab, das alle Zellen darstellt, die zu einem beliebigen Zeitpunkt einen Wert enthalten haben.
	Visible	Ruft einen Microsoft.Office.Interop.Excel.XlSheetVisibility-Wert ab, der angibt, ob das Objekt sichtbar ist, oder legt diesen fest.
	VPageBreaks	Ruft eine Microsoft.Office.Interop.Excel.VPageBreaks-Auflistung ab, die die vertikalen Seitenumbrüche des Blatts darstellt.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	_CheckSpelling	Infrastruktur.
	_Evaluate	Infrastruktur.
	_PasteSpecial	Infrastruktur.
	_PrintOut	Infrastruktur.
	_Protect	Infrastruktur.
	_SaveAs	Infrastruktur.
	Activate	Aktiviert das aktuelle Blatt.
	Arcs	Infrastruktur.
	BeginInit	Signalisiert dem Objekt den Start der Initialisierung. (Von ISupportInitialize geerbt.)
	Buttons	Infrastruktur.
	CalculateMethod	Berechnet die Formeln im Arbeitsblatt.
	ChartObjects	Ruft ein Objekt ab, das entweder ein einzelnes eingebettetes Diagramm (Microsoft.Office.Interop.Excel.ChartObject) oder eine Auflistung aller eingebetteten Diagramme (Microsoft.Office.Interop.Excel.ChartObjects) im Arbeitsblatt darstellt.
	CheckBoxes	Infrastruktur.
	CheckSpelling	Überprüft die Rechtschreibung auf einem Arbeitsblatt.
	CircleInvalid	Kreist ungültige Einträge auf dem Arbeitsblatt ein.
	ClearArrows	Entfernt die Spurpfeile vom Arbeitsblatt.Spurpfeile werden unter Verwendung des Überwachungsfeatures hinzugefügt.
	ClearCircles	Entfernt Kreise aus ungültigen Einträgen im Arbeitsblatt.
	Copy	Kopiert das Arbeitsblatt an eine andere Position in der Arbeitsmappe.
	Delete	Löscht das zugrunde liegende Microsoft.Office.Interop.Excel.Worksheet-Objekt, nicht jedoch das Hostelement.Es wird dringend davon abgeraten, diese Methode zu verwenden.
	Dispose	Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
	DrawingObjects	Infrastruktur.
	Drawings	Infrastruktur.
	DropDowns	Infrastruktur.
	EndInit	Signalisiert dem Objekt den Abschluss der Initialisierung. (Von ISupportInitialize geerbt.)
	Evaluate	Konvertiert einen Microsoft Office Excel-Namen in ein Objekt oder einen Wert.
	ExportAsFixedFormat	Exportiert eine Datei des angegebenen Formats.
	get_Range	Ruft ein Microsoft.Office.Interop.Excel.Range-Objekt ab, das eine Zelle oder einen Zellenbereich darstellt.Verwenden Sie anstelle dieser Methode die Range-Eigenschaft.
	GroupBoxes	Infrastruktur.
	GroupObjects	Infrastruktur.
	Labels	Infrastruktur.
	Lines	Infrastruktur.
	ListBoxes	Infrastruktur.
	Move	Verschiebt das Arbeitsblatt an eine andere Position in der Arbeitsmappe.
	OLEObjects	Ruft ein Objekt ab, das entweder ein einzelnes OLE-Objekt (Microsoft.Office.Interop.Excel.OLEObject) oder eine Auflistung aller OLE-Objekte (eine Microsoft.Office.Interop.Excel.OLEObjects-Auflistung) im Arbeitsblatt darstellt.
	OptionButtons	Infrastruktur.
	Ovals	Infrastruktur.
	Paste	Fügt den Inhalt der Zwischenablage in das Arbeitsblatt ein.
	PasteSpecial	Fügt den Inhalt der Zwischenablage mit einem angegebenen Format in das Arbeitsblatt ein.Verwenden Sie diese Methode, um Daten aus anderen Anwendungen einzufügen oder um Daten eines bestimmten Formats einzufügen.
	Pictures	Infrastruktur.
	PivotTables	Ruft ein Objekt ab, das entweder einen einzelnen PivotTable-Bericht (ein Microsoft.Office.Interop.Excel.PivotTable-Objekt) oder eine Auflistung aller PivotTable-Berichte (ein Microsoft.Office.Interop.Excel.PivotTables-Objekt) auf einem Arbeitsblatt darstellt.
	PivotTableWizard	Erstellt ein Microsoft.Office.Interop.Excel.PivotTable-Objekt.
	PrintOut	Druckt das Arbeitsblatt.
	PrintOutEx	Druckt das Arbeitsblatt.
	PrintPreview	Zeigt eine Vorschau des Arbeitsblatts für den Druck an.
	Protect	Schützt ein Arbeitsblatt, sodass es nicht geändert werden kann.
	Rectangles	Infrastruktur.
	ResetAllPageBreaks	Setzt alle Seitenumbrüche auf dem angegebenen Arbeitsblatt zurück.
	SaveAs	Speichert Änderungen am Arbeitsblatt in einer anderen Datei.
	Scenarios	Ruft ein Objekt ab, das entweder ein einzelnes Szenario (ein Microsoft.Office.Interop.Excel.Scenario-Objekt) oder eine Auflistung von Szenarien (ein Microsoft.Office.Interop.Excel.Scenarios-Objekt) im Arbeitsblatt darstellt.
	ScrollBars	Infrastruktur.
	Select	Wählt das Arbeitsblatt aus.
	SetBackgroundPicture	Legt die Hintergrundgrafik für das Arbeitsblatt fest.
	ShowAllData	Macht alle Zeilen der derzeit gefilterten Liste sichtbar.Wenn AutoFilter gerade verwendet wird, ändert diese Methode die Pfeile in "All".
	ShowDataForm	Zeigt das dem Arbeitsblatt zugeordnete Datenformular an.
	Spinners	Infrastruktur.
	TextBoxes	Infrastruktur.
	Unprotect	Hebt den Schutz für das Arbeitsblatt auf.Diese Methode hat keine Auswirkungen, wenn das Arbeitsblatt nicht geschützt ist.
	XmlDataQuery	Ruft ein Range-Objekt ab, das die einem bestimmten XPath zugeordneten Zellen darstellt.Ruft nullNULL-Verweis (Nothing in Visual Basic) ab, wenn dem Arbeitsblatt nicht der angegebene XPath zugeordnet wurde oder wenn der zugeordnete Bereich leer ist.
	XmlMapQuery	Ruft ein Range-Objekt ab, das die einem bestimmten XPath zugeordneten Zellen darstellt.Ruft nullNULL-Verweis (Nothing in Visual Basic) ab, wenn der angegebene XPath dem Arbeitsblatt nicht zugeordnet wurde.

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	ActivateEvent	Tritt auf, wenn das Arbeitsblatt aktiviert ist.
	BeforeDoubleClick	Tritt auf, wenn der Benutzer auf das Arbeitsblatt doppelklickt, bevor die Standarddoppelklickaktion ausgeführt wird.
	BeforeRightClick	Tritt auf, wenn mit der rechten Maustaste auf das Arbeitsblatt geklickt wird, bevor die Standardklickaktion mit der rechten Maustaste ausgeführt wird.
	BindingContextChanged	Infrastruktur.
	Calculate	Tritt auf, nachdem das Arbeitsblatt neu berechnet wurde.
	Change	Tritt ein, wenn Änderungen in den Worksheet-Zellen auftreten.
	Deactivate	Tritt auf, wenn das Arbeitsblatt nicht mehr den Fokus hat.
	Disposed	Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)
	FollowHyperlink	Tritt auf, wenn Sie auf einen Link auf einem Arbeitsblatt klicken.
	PivotTableAfterValueChange	Tritt ein, nachdem eine Zelle oder ein Bereich von Zellen (mit Formeln) in einer PivotTable bearbeitet oder neu berechnet wird.Dieses Ereignis kann nur in Excel 2010-Projekten verwendet werden.
	PivotTableBeforeAllocateChanges	Tritt ein, bevor Änderungen für eine PivotTable übernommen werden.Dieses Ereignis kann nur in Excel 2010-Projekten verwendet werden.
	PivotTableBeforeCommitChanges	Tritt ein, bevor ein Commit der Änderungen an einer PivotTable in der OLAP-Datenquelle ausgeführt wird.Dieses Ereignis kann nur in Excel 2010-Projekten verwendet werden.
	PivotTableBeforeDiscardChanges	Tritt ein, bevor Änderungen an einer PivotTable verworfen werden.Dieses Ereignis kann nur in Excel 2010-Projekten verwendet werden.
	PivotTableChangeSync	Tritt ein, nachdem eine PivotTable geändert wurde.Dieses Ereignis kann nur in Excel 2010-Projekten verwendet werden.
	PivotTableUpdate	Tritt auf, nachdem ein PivotTable-Bericht auf einem Arbeitsblatt aktualisiert wurde.
	SelectionChange	Tritt auf, wenn die Auswahl auf einem Arbeitsblatt geändert wird.
	Shutdown	Tritt auf, wenn das Arbeitsblatthostelement heruntergefahren wird.
	Startup	Tritt auf, nachdem das Arbeitsblatt ausgeführt wird und der gesamte Initialisierungscode in der Assembly ausgeführt wurde.

Zum Seitenanfang

Hinweise

Ein Microsoft.Office.Tools.Excel.Worksheet-Objekt stellt dieselben Member wie das Microsoft.Office.Interop.Excel.Worksheet-Objekt aus der primären Excel-Interop-Assembly bereit. Folgende Features werden jedoch hinzugefügt:

Controls-Eigenschaft. Verwenden Sie diese Eigenschaft, um einer Excel-Arbeitsmappe zur Laufzeit verwaltete Steuerelemente hinzuzufügen oder diese zu entfernen.
InnerObject-Eigenschaft. Verwenden Sie diese Eigenschaft, um das zugrunde liegende Microsoft.Office.Interop.Excel.Worksheet-Objekt für ein Microsoft.Office.Tools.Excel.Worksheet-Hostelement abzurufen.
Ereignisse auf Arbeitsblattebene, wie z. B. ActivateEvent und Change, die im Excel-Objektmodell nur auf der Anwendungsebene zur Verfügung stehen. Das heißt, dass diese Ereignisse im Excel-Objektmodell in der Microsoft.Office.Interop.Excel.Application-Klasse an Stelle der Microsoft.Office.Interop.Excel.Worksheet-Schnittstelle definiert werden.

In Projekten auf Anwendungsebene können Sie Microsoft.Office.Tools.Excel.Worksheet-Objekte programmgesteuert mit der GetVstoObject-Methode erstellen. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

In Projekten auf Dokumentebene verwenden Sie in der Regel kein Microsoft.Office.Tools.Excel.Worksheet-Objekt direkt. Verwenden Sie stattdessen die Sheet n-Klassen, um programmgesteuert auf die Arbeitsblätter im Projekt zuzugreifen. Jede Sheetn-Klasse leitet die meisten seiner Member aus der Microsoft.Office.Tools.Excel.WorksheetBase-Klasse ab. Diese Klasse leitet alle Aufrufe seiner Member an eine interne Implementierung der Microsoft.Office.Tools.Excel.Worksheet-Schnittstelle in Visual Studio Tools for Office-Laufzeit um. Weitere Informationen finden Sie unter Programmieren von Anpassungen auf Dokumentebene.

Tipp

Diese Schnittstelle wird von der Visual Studio Tools for Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Übersicht über die Visual Studio Tools for Office-Laufzeit.

Verwendung

In dieser Dokumentation wird die Version dieses Typs beschrieben, der in Office-Projekten mit der Zielversion .NET Framework 4 verwendet wird. In Projekten mit der Zielversion .NET Framework 3.5 verfügt dieser Typ möglicherweise über unterschiedliche Member und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Dokumentation zu diesem Typ in Projekten mit der Zielversion .NET Framework 3.5 finden Sie im folgenden Verweisabschnitt in der Visual Studio 2008-Dokumentation: https://go.microsoft.com/fwlink/?LinkId=160658.