Cette documentation est archivée et n’est pas conservée.

ControlCollection, classe

Fournit un conteneur de collection qui permet à des contrôles serveur ASP.NET de maintenir une liste de leurs contrôles enfants.

Espace de noms : System.Web.UI
Assembly : System.Web (dans system.web.dll)

public class ControlCollection : ICollection, IEnumerable
public class ControlCollection implements ICollection, IEnumerable
public class ControlCollection implements ICollection, IEnumerable

Vous pouvez accéder aux propriétés et méthodes de la classe ControlCollection à l'aide de la propriété Control.Controls. Comme la classe Control est la classe de base de tous les contrôles serveur ASP.NET, tous les contrôles serveur héritent de cette propriété.

Pour plus d'informations sur les collections, consultez Collections et structures de données.

L'exemple de code suivant substitue la méthode Control.CreateChildControls de création de deux contrôles, deux instances de la classe personnalisée appelée ChildControl, qui a une propriété de type chaîne appelée Message. Une fois créés, les deux contrôles sont ajoutés à ControlCollection. La méthode Add est appelée sur ces deux contrôles pour les ajouter à la classe qui contient cette version de Control.CreateChildControls. La propriété ChildControlsCreated a la valeur true pour que ces contrôles ne soient pas recréés inutilement.


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;
}


System.Object
  System.Web.UI.ControlCollection
     Classes dérivées

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: