ControlCollection ControlCollection ControlCollection ControlCollection Class

Definition

Stellt ASP.NET-Serversteuerelementen einen Auflistungscontainer für das Verwalten einer Liste der entsprechenden untergeordneten Steuerelemente bereitProvides a collection container that enables ASP.NET server controls to maintain a list of their child controls.

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
ControlCollectionControlCollectionControlCollectionControlCollection
Abgeleitet
Implementiert

Beispiele

Im folgenden Codebeispiel Beispiel setzt die Control.CreateChildControls Methode zum Erstellen von zwei Steuerelementen, die beide Instanzen von der benutzerdefinierten Klasse ChildControl, das ist einer Zeichenfolgeneigenschaft, die mit dem Namen Message.The following code example overrides the Control.CreateChildControls method to create two controls, both instances of the custom class named ChildControl, which has a string property named Message. Wenn erstellt, werden die beiden Steuerelemente hinzugefügt, auf die ControlCollection.When created, the two controls are added to the ControlCollection. Die Add Methode wird aufgerufen, auf jedem dieser Steuerelemente, um sie hinzuzufügen, die dieser Version enthält die Klasse Control.CreateChildControls.The Add method is called on each of these controls to add them to the class that contains this version of Control.CreateChildControls. Die ChildControlsCreated -Eigenschaftensatz auf true , damit diese Steuerelemente nicht unnötigerweise erneut erstellt werden.The ChildControlsCreated property is set to true so that these controls will not be created again unnecessarily.


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 'CreateChildControls


Hinweise

Es stehen die Eigenschaften und Methoden der ControlCollection Klasse über die Control.Controls Eigenschaft.You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Da die Control Klasse ist die Basisklasse für alle ASP.NET-Serversteuerelemente, alle Steuerelemente erben diese Eigenschaft.Since the Control class is the base class for all ASP.NET server controls, all server controls inherit this property.

Weitere Informationen zu Sammlungen finden Sie unter Auflistungen und Datenstrukturen.For more information about collections, see Collections and Data Structures.

Konstruktoren

ControlCollection(Control) ControlCollection(Control) ControlCollection(Control) ControlCollection(Control)

Initialisiert eine neue Instanz der ControlCollection-Klasse für das angegebene übergeordnete ServersteuerelementInitializes a new instance of the ControlCollection class for the specified parent server control.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Serversteuerelemente im ControlCollection-Objekt für das angegebene ASP.NET-Serversteuerelement ab.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ruft einen Wert ab, der angibt, ob das ControlCollection schreibgeschützt ist.Gets a value indicating whether the ControlCollection object is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ruft einen Wert ab, der angibt, ob das ControlCollection-Objekt synchronisiert ist.Gets a value indicating whether the ControlCollection object is synchronized.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft im ControlCollection-Objekt an der angegebenen Indexposition einen Verweis auf das Serversteuerelement abGets a reference to the server control at the specified index location in the ControlCollection object.

Owner Owner Owner Owner

Ruft das ASP.NET-Serversteuerelement ab, zu dem das ControlCollection-Objekt gehörtGets the ASP.NET server control to which the ControlCollection object belongs.

SyncRoot SyncRoot SyncRoot SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf die Steuerelementauflistung synchronisiert werden kannGets an object that can be used to synchronize access to the collection of controls.

Methoden

Add(Control) Add(Control) Add(Control) Add(Control)

Fügt der Auflistung das angegebene Control-Objekt hinzu.Adds the specified Control object to the collection.

AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control)

Fügt der Auflistung das angegebene Control-Objekt an der angegebenen Indexposition hinzu.Adds the specified Control object to the collection at the specified index location.

Clear() Clear() Clear() Clear()

Entfernt sämtliche Steuerelemente aus dem ControlCollection-Objekt des aktuellen Serversteuerelements.Removes all controls from the current server control's ControlCollection object.

Contains(Control) Contains(Control) Contains(Control) Contains(Control)

Bestimmt, ob sich das angegebene Serversteuerelement im ControlCollection-Objekt des übergeordneten Serversteuerelements befindetDetermines whether the specified server control is in the parent server control's ControlCollection object.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Kopiert die im ControlCollection-Objekt gespeicherten untergeordneten Steuerelemente in ein Array-Objekt. Dabei wird mit der angegebenen Indexposition im Array begonnen.Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Ruft einen Enumerator ab, der das ControlCollection-Objekt durchlaufen kannRetrieves an enumerator that can iterate through the ControlCollection object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Control) IndexOf(Control) IndexOf(Control) IndexOf(Control)

Ruft den Index eines angegebenen Control-Objekts in der Auflistung abRetrieves the index of a specified Control object in the collection.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(Control) Remove(Control) Remove(Control) Remove(Control)

Entfernt das angegebene Serversteuerelement aus dem ControlCollection-Objekt des übergeordneten ServersteuerelementsRemoves the specified server control from the parent server control's ControlCollection object.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Entfernt ein untergeordnetes Steuerelement an der angegebenen Indexposition aus dem ControlCollection-ObjektRemoves a child control, at the specified index location, from the ControlCollection object.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert eine IEnumerable auf eine IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch