Teilen über

ControlCollection Klasse

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Stellt ASP.NET-Serversteuerelementen einen Auflistungscontainer für das Verwalten einer Liste der entsprechenden untergeordneten Steuerelemente bereit

public ref class ControlCollection : System::Collections::ICollection
public class ControlCollection : System.Collections.ICollection
type ControlCollection = class
    interface ICollection
    interface IEnumerable
Public Class ControlCollection
Implements ICollection
Vererbung
Object
ControlCollection
Abgeleitet
Implementiert
ICollection IEnumerable

Beispiele

Im folgenden Codebeispiel wird die Control.CreateChildControls -Methode zum Erstellen von zwei Steuerelementen überschrieben, beide Instanzen der benutzerdefinierten Klasse namens ChildControl, die über eine Zeichenfolgeneigenschaft namens verfügt Message. Bei der Erstellung werden die beiden Steuerelemente dem ControlCollectionhinzugefügt. Die Add -Methode wird für jedes dieser Steuerelemente aufgerufen, um sie der Klasse hinzuzufügen, die diese Version von Control.CreateChildControlsenthält. Die ChildControlsCreated -Eigenschaft wird auf true festgelegt, damit diese Steuerelemente nicht unnötigerweise erneut erstellt werden.


protected override void CreateChildControls()
{               
   // Creates a new ControlCollection. 
   this.CreateControlCollection();

   // Create child controls.
    ChildControl firstControl = new ChildControl();
   firstControl.Message = "FirstChildControl";

   ChildControl secondControl = new ChildControl();
   secondControl.Message = "SecondChildControl";
   
   Controls.Add(firstControl);
   Controls.Add(secondControl);

   // Prevent child controls from being created again.
   ChildControlsCreated = true;
}


Protected Overrides Sub CreateChildControls()
   ' Creates a new ControlCollection. 
   Me.CreateControlCollection()
   
   ' Create child controls.
   Dim firstControl As New ChildControl()
   firstControl.Message = "FirstChildControl"
   
   Dim secondControl As New ChildControl()
   secondControl.Message = "SecondChildControl"
   
   Controls.Add(firstControl)
   Controls.Add(secondControl)
   
   ' Prevent child controls from being created again.
   ChildControlsCreated = True
End Sub

Hinweise

Sie können über Control.Controls die -Eigenschaft auf alle Eigenschaften und Methoden der ControlCollection -Klasse zugreifen. Da die Control -Klasse die Basisklasse für alle ASP.NET-Serversteuerelemente ist, erben alle Serversteuerelemente diese Eigenschaft.

Weitere Informationen zu Sammlungen finden Sie unter Sammlungen und Datenstrukturen.

Konstruktoren

ControlCollection(Control)

Initialisiert eine neue Instanz der ControlCollection-Klasse für das angegebene übergeordnete Serversteuerelement

Eigenschaften

Count

Ruft die Anzahl der Serversteuerelemente im ControlCollection-Objekt für das angegebene ASP.NET-Serversteuerelement ab.
IsReadOnly

Ruft einen Wert ab, der angibt, ob das ControlCollection schreibgeschützt ist.
IsSynchronized

Ruft einen Wert ab, der angibt, ob das ControlCollection-Objekt synchronisiert ist.
Item[Int32]

Ruft im ControlCollection-Objekt an der angegebenen Indexposition einen Verweis auf das Serversteuerelement ab
Owner

Ruft das ASP.NET-Serversteuerelement ab, zu dem das ControlCollection-Objekt gehört
SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf die Steuerelementauflistung synchronisiert werden kann

Methoden

Add(Control)

Fügt der Auflistung das angegebene Control-Objekt hinzu.
AddAt(Int32, Control)

Fügt der Auflistung das angegebene Control-Objekt an der angegebenen Indexposition hinzu.
Clear()

Entfernt sämtliche Steuerelemente aus dem ControlCollection-Objekt des aktuellen Serversteuerelements.
Contains(Control)

Bestimmt, ob sich das angegebene Serversteuerelement im ControlCollection-Objekt des übergeordneten Serversteuerelements befindet
CopyTo(Array, Int32)

Kopiert die im ControlCollection-Objekt gespeicherten untergeordneten Steuerelemente in ein Array-Objekt. Dabei wird mit der angegebenen Indexposition im Array begonnen.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetEnumerator()

Ruft einen Enumerator ab, der das ControlCollection-Objekt durchlaufen kann.
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IndexOf(Control)

Ruft den Index eines angegebenen Control-Objekts in der Auflistung ab
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
Remove(Control)

Entfernt das angegebene Serversteuerelement aus dem ControlCollection-Objekt des übergeordneten Serversteuerelements
RemoveAt(Int32)

Entfernt ein untergeordnetes Steuerelement an der angegebenen Indexposition aus dem ControlCollection-Objekt
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Weitere Informationen