Control.Controls Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un ControlCollection oggetto che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.
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 ControlCollectionValore della proprietà
Raccolta di controlli figlio per il controllo server specificato.
- Attributi
Esempio
Nell'esempio seguente viene illustrato come aggiungere controlli figlio all'oggetto di ControlCollection un controllo server tramite la relativa Controls proprietà .
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 al controllo ControlCollectionserver contenitore. Tutti i tag HTML o le stringhe di testo non elaborati nel server vengono considerati oggetti LiteralControl . Questi vengono aggiunti alla raccolta come altri controlli server.
La Controls proprietà consente di accedere a livello di codice all'istanza della ControlCollection classe per qualsiasi controllo server. È possibile aggiungere controlli alla raccolta, rimuovere i controlli dalla raccolta o scorrere i controlli server nella raccolta.
Note per gli eredi
Quando si esegue l'override della Controls proprietà, assicurarsi di chiamare il EnsureChildControls() metodo . Inoltre, se si prevede di aggiungere controlli alla raccolta di controlli a livello di codice, è consigliabile aggiungere i controlli in un metodo sottoposto CreateChildControls() a override.
