Control.Controls Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.ControlCollectionPublic Overridable ReadOnly Property Controls As ControlCollectionValeur de propriété
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() .