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 oggetto ControlCollection 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.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection
Valore 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 del ControlCollectionserver contenente . Tutti i tag HTML o le stringhe di testo non elaborati nel server vengono trattati come LiteralControl oggetti. Vengono aggiunti alla raccolta come altri controlli server.
La Controls proprietà consente l'accesso a livello di codice all'istanza ControlCollection della classe per qualsiasi controllo server. È possibile aggiungere controlli alla raccolta, rimuovere i controlli dalla raccolta o eseguire l'iterazione tramite 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.