ControlCollection-Klasse
Stellt ASP.NET-Serversteuerelementen einen Auflistungscontainer für das Verwalten einer Liste der entsprechenden untergeordneten Steuerelemente bereit.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class ControlCollection
Implements ICollection, IEnumerable
'Usage
Dim instance As ControlCollection
public class ControlCollection : ICollection, IEnumerable
public ref class ControlCollection : ICollection, IEnumerable
public class ControlCollection implements ICollection, IEnumerable
public class ControlCollection implements ICollection, IEnumerable
Hinweise
Über die Control.Controls-Eigenschaft kann auf sämtliche Eigenschaften und Methoden der ControlCollection-Klasse zugegriffen werden. Da die Control-Klasse die Basisklasse aller ASP.NET-Serversteuerelemente ist, erben sämtliche Serversteuerelemente diese Eigenschaft.
Weitere Informationen über Auflistungen finden Sie unter Auflistungen und Datenstrukturen.
Beispiel
Im folgenden Codebeispiel wird die Control.CreateChildControls-Methode überschrieben, um zwei Steuerelemente zu erstellen. Die beiden Steuerelemente sind Instanzen der benutzerdefinierten Klasse ChildControl, die eine Zeichenfolgeneigenschaft mit dem Namen Message besitzt. Beide Steuerelemente werden beim Erstellungsvorgang ControlCollection hinzugefügt. Für beide Steuerelemente wird die Add-Methode aufgerufen, um sie der Klasse hinzuzufügen, die diese Version von Control.CreateChildControls enthält. Die ChildControlsCreated-Eigenschaft ist auf true festgelegt, sodass diese Steuerelemente nicht unnötigerweise noch einmal erstellt werden.
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 'CreateChildControls
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;
}
Vererbungshierarchie
System.Object
System.Web.UI.ControlCollection
Abgeleitete Klassen
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
ControlCollection-Member
System.Web.UI-Namespace
Control-Klasse
Page
Control.Controls-Eigenschaft