Control.Controls Control.Controls Control.Controls Control.Controls Property

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.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

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; }
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

Valeur de propriété

Collection de contrôles enfants pour le contrôle serveur spécifié.The collection of child controls for the specified server control.

Exemples

L’exemple suivant montre comment ajouter des contrôles enfants à l’objet d' ControlCollection un contrôle serveur par le biais de sa Controls propriété.The following example demonstrates how to add child controls to a server control's ControlCollection object through its Controls property.

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

Remarques

Sur une page ASP.NET, lorsque des contrôles sont ajoutés de façon déclarative entre les balises d’ouverture et de fermeture d’un contrôle serveur, ASP.NET ajoute automatiquement les contrôles ControlCollectionau du contrôle serveur contenant.On an ASP.NET page, when controls are added declaratively between the opening and closing tags of a server control, ASP.NET automatically adds the controls to the containing server control's ControlCollection. Les balises HTML ou les chaînes de texte qui ne sont pas traitées sur le LiteralControl serveur sont traitées comme des objets.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. Celles-ci sont ajoutées à la collection comme d’autres contrôles serveur.These are added to the collection like other server controls.

La Controls propriété vous permet d’accéder par programme à l’instance ControlCollection de la classe pour n’importe quel contrôle serveur.The Controls property allows you programmatic access to the instance of the ControlCollection class for any server control. Vous pouvez ajouter des contrôles à la collection, supprimer des contrôles de la collection ou itérer au sein des contrôles serveur de la collection.You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.

Notes pour les héritiers

Lors de la substitution Controls de la propriété, veillez à EnsureChildControls() appeler la méthode.When overriding the Controls property, be sure to call the EnsureChildControls() method. En outre, si vous envisagez d’ajouter des contrôles à la collection de contrôles par programme, envisagez d’ajouter CreateChildControls() les contrôles dans une méthode substituée.Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls() method.

S’applique à

Voir aussi