Freigeben über


ControlCollection-Schnittstelle

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
Öffentliche Eigenschaft Count Ruft die Anzahl der Steuerelemente in der ControlCollection ab.
Öffentliche Eigenschaft Item[Int32] Ruft das Steuerelement am angegebenen Index ab.
Öffentliche Eigenschaft Item[String] Ruft das Steuerelement mit dem angegebenen Namen ab.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode AddChart(Range, String) Fügt dem Arbeitsblatt im angegebenen Bereich ein neues Chart-Steuerelement hinzu.
Öffentliche Methode AddChart(Double, Double, Double, Double, String) Fügt dem Arbeitsblatt an der angegebenen Position ein neues Chart-Steuerelement in der angegebenen Größe hinzu.
Öffentliche Methode AddControl(Control, Range, String) Fügt der ControlCollection im angegebenen Bereich das angegebene Control hinzu.
Öffentliche Methode AddControl(Control, Double, Double, Double, Double, String) Fügt der ControlCollection an der angegebenen Position das festgelegte Control der angegebenen Größe hinzu.
Öffentliche Methode 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.
Öffentliche Methode AddListObject(Range, String) Fügt dem Arbeitsblatt im angegebenen Bereich ein neues ListObject-Steuerelement hinzu.
Öffentliche Methode AddNamedRange Fügt dem Arbeitsblatt im angegebenen Bereich ein neues NamedRange-Steuerelement hinzu.
Öffentliche Methode Contains(Object) Bestimmt, ob das angegebene Steuerelement ein Member der ControlCollection-Instanz ist.
Öffentliche Methode Contains(String) Bestimmt, ob ein Steuerelement mit dem angegebenen Namen ein Member der ControlCollection-Instanz ist.
Öffentliche Methode GetEnumerator Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von IEnumerable geerbt.)
Öffentliche Methode IndexOf(Object) Sucht nach dem angegebenen Steuerelement und gibt den nullbasierten Index des ersten Vorkommens in der ControlCollection-Instanz zurück.
Öffentliche Methode IndexOf(String) Sucht nach dem ersten Vorkommen eines Steuerelements mit dem angegebenen Namen in der ControlCollection-Instanz.
Öffentliche Methode Remove(Object) Entfernt das angegebene Steuerelement aus der ControlCollection-Instanz.
Öffentliche Methode Remove(String) Entfernt das Steuerelement mit dem angegebenen Namen aus der ControlCollection-Instanz.
Öffentliche Methode 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