ControlCollection Classe

  • Référence

Définition

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

Fournit un conteneur de collection qui permet à des contrôles serveur ASP.NET de maintenir une 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. Une fois créés, les deux contrôles sont ajoutés à .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 sur true afin 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

ControlCollection(Control)

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

Propriétés

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 l'objet ControlCollection appartient.
SyncRoot

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

Méthodes

Add(Control)

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

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

Supprime tous les contrôles de l'objet ControlCollection du contrôle serveur en cours.
Contains(Control)

Détermine si le contrôle serveur spécifié se trouve dans l'objet ControlCollection du contrôle serveur parent.
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.
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 effectuer une itération au sein de l'objet ControlCollection.
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

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

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

Crée une copie superficielle du Object actuel.

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

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

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

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

(Hérité de Object)

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)

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

Convertit un IEnumerable en IQueryable.

S’applique à

Voir aussi