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
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

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

Le type ControlCollection expose les membres suivants.

  Nom Description
Méthode publique ControlCollection Initialise une nouvelle instance de la classe ControlCollection pour le contrôle serveur parent spécifié.
Début
  Nom Description
Propriété publique Count Obtient le nombre de contrôles serveur dans l'objet ControlCollection pour le contrôle serveur ASP.NET spécifié.
Propriété publique IsReadOnly Obtient une valeur indiquant si l'objet ControlCollection est en lecture seule.
Propriété publique IsSynchronized Obtient une valeur indiquant la synchronisation ou non de l'objet ControlCollection.
Propriété publique Item Obtient une référence au contrôle serveur à l'emplacement d'index spécifié dans l'objet ControlCollection.
Propriété protégée Owner Obtient le contrôle serveur ASP.NET auquel l'objet ControlCollection appartient.
Propriété publique SyncRoot Obtient un objet qui peut être utilisé pour synchroniser l'accès à la collection de contrôles.
Début
  Nom Description
Méthode publique Add Ajoute l'objet Control spécifié à la collection.
Méthode publique AddAt Ajoute l'objet Control spécifié à la collection à l'emplacement d'index spécifié.
Méthode publique Clear Supprime tous les contrôles de l'objet ControlCollection du contrôle serveur en cours.
Méthode publique Contains Détermine si le contrôle serveur spécifié se trouve dans l'objet ControlCollection du contrôle serveur parent.
Méthode publique 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.
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée 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.)
Méthode publique GetEnumerator Récupère un énumérateur qui peut itérer au sein de l'objet ControlCollection.
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique IndexOf Récupère l'index d'un objet Control spécifié dans la collection.
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique Remove Supprime le contrôle serveur spécifié de l'objet ControlCollection du contrôle serveur parent.
Méthode publique RemoveAt Supprime un contrôle enfant de l'objet ControlCollection, à l'emplacement d'index spécifié.
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début
  Nom Description
Méthode d'extension publique AsParallel Active la parallélisation d'une requête. (Défini par ParallelEnumerable.)
Méthode d'extension publique AsQueryable Convertit un IEnumerable en IQueryable. (Défini par Queryable.)
Méthode d'extension publique Cast<TResult> Convertit les éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.)
Méthode d'extension publique OfType<TResult> Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.)
Début

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



.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

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.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ