Partager via


Control.Controls Propriété

Définition

Obtient un objet ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur.

public:
 virtual property System::Web::UI::ControlCollection ^ Controls { System::Web::UI::ControlCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.ControlCollection Controls { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

Valeur de propriété

ControlCollection

Collection de contrôles enfants pour le contrôle serveur spécifié.

Attributs

Exemples

L’exemple suivant montre comment ajouter des contrôles enfants à l’objet d’un ControlCollection contrôle serveur via sa Controls propriété.

Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(New LiteralControl("<h3>Value: "))
  

Remarques

Dans une page ASP.NET, lorsque des contrôles sont ajoutés de manière déclarative entre les balises d’ouverture et de fermeture d’un contrôle serveur, ASP.NET ajoute automatiquement les contrôles au contrôle ControlCollectionserveur conteneur. Toutes les balises HTML ou chaînes de texte qui ne sont pas traitées sur le serveur sont traitées comme LiteralControl des objets. Ceux-ci sont ajoutés à la collection comme d’autres contrôles serveur.

La Controls propriété vous permet d’accéder par programmation à l’instance de la ControlCollection classe pour n’importe quel contrôle serveur. Vous pouvez ajouter des contrôles à la collection, supprimer des contrôles de la collection ou effectuer une itération via les contrôles serveur de la collection.

Notes pour les héritiers

En cas de substitution de la Controls propriété, veillez à appeler la EnsureChildControls() méthode. En outre, si vous envisagez d’ajouter des contrôles à la collection de contrôles par programmation, envisagez d’ajouter les contrôles dans une méthode substituée CreateChildControls() .

S’applique à

Voir aussi