Partager via

ControlCollection Classe

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Fournit un conteneur de collection qui permet aux contrôles serveur ASP.NET de conserver la liste de leurs contrôles enfants.

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
Héritage
Object
ControlCollection
Dérivé
Implémente
ICollection IEnumerable

Exemples

L’exemple de code suivant remplace la Control.CreateChildControls méthode pour créer deux contrôles, les deux instances de la classe personnalisée nommée ChildControl, qui a une propriété de chaîne nommée Message. Lors de la création, les deux contrôles sont ajoutés au ControlCollection. La Add méthode est appelée sur chacun de ces contrôles pour les ajouter à la classe qui contient cette version de Control.CreateChildControls. La ChildControlsCreated propriété est définie pour true que ces contrôles ne soient pas créé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;
}


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

Remarques

Vous pouvez accéder à l’une des propriétés et méthodes de la ControlCollection classe via la Control.Controls propriété. Étant donné que la Control classe est la classe de base pour 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.

Constructeurs

Nom Description
ControlCollection(Control)

Initialise une nouvelle instance de la ControlCollection classe pour le contrôle serveur parent spécifié.

Propriétés

Nom Description
Count

Obtient le nombre de contrôles serveur dans l’objet ControlCollection pour le contrôle serveur ASP.NET spécifié.
IsReadOnly

Obtient une valeur indiquant si l’objet ControlCollection est en lecture seule.
IsSynchronized

Obtient une valeur indiquant si l’objet ControlCollection est synchronisé.
Item[Int32]

Obtient une référence au contrôle serveur à l’emplacement d’index spécifié dans l’objet ControlCollection .
Owner

Obtient le contrôle serveur ASP.NET auquel appartient l’objet ControlCollection .
SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection de contrôles.

Méthodes

Nom Description
Add(Control)

Ajoute l’objet spécifié Control à la collection.
AddAt(Int32, Control)

Ajoute l’objet spécifié Control à la collection à l’emplacement d’index spécifié.
Clear()

Supprime tous les contrôles de l’objet du ControlCollection contrôle serveur actuel.
Contains(Control)

Détermine si le contrôle serveur spécifié se trouve dans l’objet du ControlCollection contrôle serveur parent.
CopyTo(Array, Int32)

Copie les contrôles enfants stockés dans l’objet ControlCollection dans un Array objet, en commençant à l’emplacement d’index spécifié dans le Array.
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetEnumerator()

Récupère un énumérateur qui peut itérer au sein de l’objet ControlCollection .
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
IndexOf(Control)

Récupère l’index d’un objet spécifié Control dans la collection.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
Remove(Control)

Supprime le contrôle serveur spécifié de l’objet du ControlCollection contrôle serveur parent.
RemoveAt(Int32)

Supprime un contrôle enfant, à l’emplacement d’index spécifié, de l’objet ControlCollection .
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

Méthodes d’extension

Nom Description
AsParallel(IEnumerable)

Active la parallélisation d’une requête.
AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.
Cast<TResult>(IEnumerable)

Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)

Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

S’applique à

Voir aussi