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

Definizione

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.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

Valore della proprietà

Raccolta di controlli figlio per il controllo server specificato.The collection of child controls for the specified server control.

Esempi

Nell'esempio seguente viene illustrato come aggiungere controlli figlio a un oggetto di ControlCollection un controllo server tramite la relativa Controls proprietà.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: "))
  

Commenti

In una pagina ASP.NET, quando i controlli vengono aggiunti in modo dichiarativo tra i tag di apertura e chiusura di un controllo server, ASP.NET aggiunge automaticamente i controlli all' ControlCollectionoggetto contenitore del controllo server.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. Eventuali tag HTML o stringhe di testo non elaborati nel server vengono considerati LiteralControl oggetti.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. Questi vengono aggiunti alla raccolta come altri controlli server.These are added to the collection like other server controls.

La Controls proprietà consente di accedere a livello di codice all'istanza ControlCollection della classe per qualsiasi controllo server.The Controls property allows you programmatic access to the instance of the ControlCollection class for any server control. È possibile aggiungere controlli alla raccolta, rimuovere i controlli dalla raccolta o scorrere i controlli server nella raccolta.You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.

Note per gli eredi

Quando si esegue l' Controls override della proprietà, assicurarsi di chiamare EnsureChildControls() il metodo.When overriding the Controls property, be sure to call the EnsureChildControls() method. Inoltre, se si prevede di aggiungere controlli alla raccolta di controlli a livello di codice, è consigliabile aggiungere i controlli in un CreateChildControls() metodo sottoposto a override.Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls() method.

Si applica a

Vedi anche