ControlCollection-Schnittstelle

Artikel
08/10/2011

Stellt eine Auflistung von verwalteten Steuerelementen auf einem Excel-Arbeitsblatt in einer Office-Projektmappe dar.

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

Syntax

'Declaration
<GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")> _
Public Interface ControlCollection _
    Inherits IEnumerable

[GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : IEnumerable

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

Eigenschaften

	Name	Beschreibung
	Count	Ruft die Anzahl der Steuerelemente in der ControlCollection ab.
	Item[Int32]	Ruft das Steuerelement am angegebenen Index ab.
	Item[String]	Ruft das Steuerelement mit dem angegebenen Namen ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddChart(Range, String)	Fügt dem Arbeitsblatt im angegebenen Bereich ein neues Chart-Steuerelement hinzu.
	AddChart(Double, Double, Double, Double, String)	Fügt dem Arbeitsblatt an der angegebenen Position ein neues Chart-Steuerelement in der angegebenen Größe hinzu.
	AddControl(Control, Range, String)	Fügt der ControlCollection im angegebenen Bereich das angegebene Control hinzu.
	AddControl(Control, Double, Double, Double, Double, String)	Fügt der ControlCollection an der angegebenen Position das festgelegte Control der angegebenen Größe hinzu.
	AddListObject(ListObject)	Fügt der Steuerelementauflistung ein Visual Studio Microsoft.Office.Tools.Excel.ListObject-Objekt auf Grundlage des angegebenen systemeigenen Microsoft.Office.Interop.Excel.ListObject-Objekts hinzu.
	AddListObject(Range, String)	Fügt dem Arbeitsblatt im angegebenen Bereich ein neues ListObject-Steuerelement hinzu.
	AddNamedRange	Fügt dem Arbeitsblatt im angegebenen Bereich ein neues NamedRange-Steuerelement hinzu.
	Contains(Object)	Bestimmt, ob das angegebene Steuerelement ein Member der ControlCollection-Instanz ist.
	Contains(String)	Bestimmt, ob ein Steuerelement mit dem angegebenen Namen ein Member der ControlCollection-Instanz ist.
	GetEnumerator	Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von IEnumerable geerbt.)
	IndexOf(Object)	Sucht nach dem angegebenen Steuerelement und gibt den nullbasierten Index des ersten Vorkommens in der ControlCollection-Instanz zurück.
	IndexOf(String)	Sucht nach dem ersten Vorkommen eines Steuerelements mit dem angegebenen Namen in der ControlCollection-Instanz.
	Remove(Object)	Entfernt das angegebene Steuerelement aus der ControlCollection-Instanz.
	Remove(String)	Entfernt das Steuerelement mit dem angegebenen Namen aus der ControlCollection-Instanz.
	RemoveAt	Entfernt das Steuerelement am angegebenen Index in der ControlCollection-Instanz.

Zum Seitenanfang

Hinweise

Verwenden Sie die Methoden und die Eigenschaften der ControlCollection-Schnittstelle, um Steuerelemente in einem Excel-Arbeitsblatt zu verwalten. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

Sie können keine Instanz dieser Schnittstelle im Code erstellen, da sie über keine öffentlichen Konstruktoren verfügt. Um eine Instanz dieser Schnittstelle in einem Projekt auf Dokumentebene abzurufen, verwenden Sie die Controls-Eigenschaft einer der Sheetn-Klassen im Projekt. Um eine Instanz dieser Schnittstelle in einem Projekt auf Dokumentebene abzurufen, verwenden Sie die Controls-Eigenschaft eines Worksheet-Hostelements, das Sie zur Laufzeit programmgesteuert erstellen. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

In der folgenden Tabelle wird gezeigt, wie Sie mit ControlCollection-Membern einige allgemeine Aufgaben ausführen können, die sich auf Steuerelemente in Dokumenten beziehen.

Aufgabe	Aktion
Fügen Sie dem Arbeitsblatt ein Steuerelement hinzu.	Verwenden Sie eine der Add<Steuerelement>-Methoden. Verwenden Sie beispielsweise zum Hinzufügen eines Microsoft.Office.Tools.Excel.ListObject die AddListObject-Methode.
Entfernen Sie ein Steuerelementen aus dem Arbeitsblatt.	Verwenden Sie die Remove-Methode.
Bestimmen Sie, ob sich ein Steuerelement in der Auflistung befindet.	Übergeben Sie das Steuerelement oder seinen Namen an die Contains-Methode.
Ruft den Index eines Steuerelements in der Auflistung ab.	Übergeben Sie das Steuerelement oder seinen Namen an die IndexOf-Methode.
Rufen Sie ein Steuerelement aus der Auflistung ab.	Übergeben Sie den Index oder Namen des Steuerelements an die Item-Eigenschaft.

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.

Siehe auch

Referenz

Microsoft.Office.Tools.Excel-Namespace

Freigeben über