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 i controlli figlio a un controllo server ControlCollection dell'oggetto tramite relativo 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 vengono aggiunti in modo dichiarativo controlli tra i tag di apertura e chiusura di un controllo server, ASP.NET aggiunge automaticamente i controlli al controllo server contenitore ControlCollection.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. Qualsiasi tag HTML o le stringhe di testo non vengono elaborate nel server vengono trattate LiteralControl oggetti.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. Vengono aggiunti alla raccolta come qualsiasi altro controllo server.These are added to the collection like other server controls.

Il Controls proprietà consente di accedere a livello di codice per l'istanza del ControlCollection 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 nell'insieme.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'override di Controls proprietà, accertarsi di chiamare il EnsureChildControls() (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, si consiglia di aggiungere i controlli nell'oggetto sottoposto a override CreateChildControls() (metodo).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