Condividi tramite


Control.Controls Proprietà

Definizione

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à

ControlCollection

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.

Si applica a

Vedi anche