Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
ControlCollection, classe
Fournit un conteneur de collection qui permet à des contrôles serveur ASP.NET de maintenir une liste de leurs contrôles enfants.
System.Web.UI.ControlCollection
System.Web.UI.EmptyControlCollection
System.Web.UI.HtmlControls.HtmlTable.HtmlTableRowControlCollection
System.Web.UI.HtmlControls.HtmlTableRow.HtmlTableCellControlCollection
System.Web.UI.WebControls.Table.RowControlCollection
System.Web.UI.WebControls.TableRow.CellControlCollection
System.Web.UI.WebControls.ViewCollection
Assembly : System.Web (dans System.Web.dll)
Le type ControlCollection expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
ControlCollection | Initialise une nouvelle instance de la classe ControlCollection pour le contrôle serveur parent spécifié. |
| 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 la synchronisation ou non de l'objet ControlCollection. |
|
Item | 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. |
| Nom | Description | |
|---|---|---|
|
Add | Ajoute l'objet Control spécifié à la collection. |
|
AddAt | 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 | Détermine si le contrôle serveur spécifié se trouve dans l'objet ControlCollection du contrôle serveur parent. |
|
CopyTo | Copie les contrôles enfants stockés dans l'objet ControlCollection vers un objet System.Array, en commençant à l'emplacement d'index spécifié dans System.Array. |
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (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 pour un type particulier. (Hérité de Object.) |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
IndexOf | Récupère l'index d'un objet Control spécifié dans la collection. |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
Remove | Supprime le contrôle serveur spécifié de l'objet ControlCollection du contrôle serveur parent. |
|
RemoveAt | 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.) |
| Nom | Description | |
|---|---|---|
|
AsParallel | Active la parallélisation d'une requête. (Défini par ParallelEnumerable.) |
|
AsQueryable | Convertit un IEnumerable en IQueryable. (Défini par Queryable.) |
|
Cast<TResult> | Convertit les éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.) |
|
OfType<TResult> | Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.) |
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;
}
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.