Control.Controls Proprietà

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.

Attributi

Esempi

Nell'esempio seguente viene illustrato come aggiungere controlli figlio a un oggetto ControlCollection di un controllo server tramite la relativa proprietà Controls.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 i controlli vengono aggiunti in modo dichiarativo tra i tag di apertura e chiusura di un controllo server, ASP.NET aggiunge automaticamente i controlli all'ControlCollectiondel controllo server contenitore.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. Eventuali tag HTML o stringhe di testo non elaborati nel server vengono considerati come LiteralControl oggetti.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. Questi vengono aggiunti alla raccolta come altri controlli server.These are added to the collection like other server controls.

Il Controls proprietà consente di accedere a livello di codice all'istanza della classe ControlCollection 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 nella raccolta.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 della proprietà Controls, assicurarsi di chiamare il metodo EnsureChildControls().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, è consigliabile aggiungere i controlli in un metodo di CreateChildControls() sottoposto a override.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