ControlCollection Class

Definition

Fournit un conteneur de collection qui permet à des contrôles serveur ASP.NET de maintenir une liste de leurs contrôles enfants.Provides 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
Inheritance
ControlCollection
Derived
Implements

Examples

L’exemple de code suivant remplace la méthode Control.CreateChildControls pour créer deux contrôles, les deux instances de la classe personnalisée nommée ChildControl, qui a une propriété de type chaîne nommée 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. Une fois créés, les deux contrôles sont ajoutés au ControlCollection.When created, the two controls are added to the ControlCollection. La méthode Add est appelée sur chacun de ces contrôles pour les ajouter à la classe qui contient cette version de 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. La propriété ChildControlsCreated est définie sur true afin que ces contrôles ne soient pas recréés inutilement.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


Remarks

Vous pouvez accéder à toutes les propriétés et méthodes de la classe ControlCollection par le biais de la propriété Control.Controls.You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Étant donné que la classe Control est la classe de base pour tous les contrôles serveur ASP.NET, tous les contrôles serveur héritent de cette propriété.Since the Control class is the base class for all ASP.NET server controls, all server controls inherit this property.

Pour plus d’informations sur les collections, consultez collections et structures de données.For more information about collections, see Collections and Data Structures.

Constructors

ControlCollection(Control)

Initialise une nouvelle instance de la classe ControlCollection pour le contrôle serveur parent spécifié.Initializes a new instance of the ControlCollection class for the specified parent server control.

Properties

Count

Obtient le nombre de contrôles serveur dans l'objet ControlCollection pour le contrôle serveur ASP.NET spécifié.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

IsReadOnly

Obtient une valeur indiquant si l’objet ControlCollection est en lecture seule.Gets a value indicating whether the ControlCollection object is read-only.

IsSynchronized

Obtient une valeur indiquant si l'objet ControlCollection est synchronisé.Gets a value indicating whether the ControlCollection object is synchronized.

Item[Int32]

Obtient une référence au contrôle serveur à l'emplacement d'index spécifié dans l'objet ControlCollection.Gets a reference to the server control at the specified index location in the ControlCollection object.

Owner

Obtient le contrôle serveur ASP.NET auquel l'objet ControlCollection appartient.Gets the ASP.NET server control to which the ControlCollection object belongs.

SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à la collection de contrôles.Gets an object that can be used to synchronize access to the collection of controls.

Methods

Add(Control)

Ajoute l'objet Control spécifié à la collection.Adds the specified Control object to the collection.

AddAt(Int32, Control)

Ajoute l'objet Control spécifié à la collection à l'emplacement d'index spécifié.Adds the specified Control object to the collection at the specified index location.

Clear()

Supprime tous les contrôles de l'objet ControlCollection du contrôle serveur en cours.Removes all controls from the current server control's ControlCollection object.

Contains(Control)

Détermine si le contrôle serveur spécifié se trouve dans l'objet ControlCollection du contrôle serveur parent.Determines whether the specified server control is in the parent server control's ControlCollection object.

CopyTo(Array, Int32)

Copie les contrôles enfants stockés dans l'objet ControlCollection vers un objet Array, en commençant à l'emplacement d'index spécifié dans Array.Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator()

Récupère un énumérateur qui peut effectuer une itération au sein de l'objet ControlCollection.Retrieves an enumerator that can iterate through the ControlCollection object.

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Control)

Récupère l'index d'un objet Control spécifié dans la collection.Retrieves the index of a specified Control object in the collection.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(Control)

Supprime le contrôle serveur spécifié de l'objet ControlCollection du contrôle serveur parent.Removes the specified server control from the parent server control's ControlCollection object.

RemoveAt(Int32)

Supprime un contrôle enfant de l'objet ControlCollection, à l'emplacement d'index spécifié.Removes a child control, at the specified index location, from the ControlCollection object.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Extension Methods

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Applies to

See also