Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.
Assembly: System.Web (in System.Web.dll)
<BrowsableAttribute(False)> _ Public Overridable ReadOnly Property Controls As ControlCollection Get
[BrowsableAttribute(false)] public virtual ControlCollection Controls { get; }
[BrowsableAttribute(false)] public: virtual property ControlCollection^ Controls { ControlCollection^ get (); }
[<BrowsableAttribute(false)>] abstract Controls : ControlCollection [<BrowsableAttribute(false)>] override Controls : ControlCollection
Valore proprietà
Tipo: System.Web.UI.ControlCollectionInsieme dei controlli figlio per il controllo server specificato.
In una pagina ASP.NET, quando i controlli sono aggiunti in maniera dichiarativa tra i tag di apertura e chiusura di un controllo server, ASP.NET aggiunge automaticamente i controlli all'oggetto ControlCollection del controllo server che funge da contenitore. Qualsiasi tag HTML o stringhe di testo non elaborate sul server vengono trattate come oggetti LiteralControl, che vengono aggiunti all'insieme come qualsiasi altro controllo server.
La proprietà Controls consente di accedere a livello di codice all'istanza della classe ControlCollection per qualsiasi controllo server. È possibile aggiungere controlli all'insieme, rimuoverli o scorrere i controlli server presenti nell'insieme.
Note per gli eredi
Quando si esegue l'override della proprietà Controls, assicurarsi di chiamare il metodo EnsureChildControls. Inoltre, se si prevede di aggiungere controlli all'insieme di controlli a livello di codice, considerare l'ipotesi di aggiungere i controlli in un metodo CreateChildControls sottoposto a override.
Nel seguente esempio viene dimostrato come aggiungere controlli figlio a un oggetto ControlCollection di un controllo server tramite la proprietà Controls.
Controls.Add(New LiteralControl("<h3>Value: "))
Controls.Add(new LiteralControl("<h3>Value: "));
pt]
this.Controls.Add(new LiteralControl("<h3>Value: "));
.NET Framework
Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2
.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.