ControlCollection Classe

Définition

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

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. MessageThe 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 Add méthode 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 ChildControlsCreated propriété a la true valeur 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


Remarques

Vous pouvez accéder à toutes les propriétés et méthodes de la ControlCollection classe par le Control.Controls biais de la propriété.You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Étant donné Control que la 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é.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.

Constructeurs

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.

Propriétés

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 la synchronisation ou non de l'objet ControlCollection.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.

Méthodes

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.

(Hérité de Object)
GetEnumerator()

Récupère un énumérateur qui peut itérer 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.

(Hérité de Object)
GetType()

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

(Hérité de 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 de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de 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.

(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é.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.

S’applique à

Voir aussi