Control.Controls Property

Definition

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.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

Property Value

ControlCollection

Die Auflistung der untergeordneten Steuerelemente für das angegebene Serversteuerelement.The collection of child controls for the specified server control.

Attributes

Examples

Das folgende Beispiel veranschaulicht das Hinzufügen von untergeordneten Steuerelementen zum ControlCollection-Objekt eines Server Steuer Elements über seine Controls-Eigenschaft.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: "))
  

Remarks

Wenn auf einer ASP.NET-Seite Steuerelemente zwischen den öffnenden und schließenden Tags eines Server Steuer Elements deklarativ hinzugefügt werden, fügt ASP.net die Steuerelemente automatisch dem ControlCollectiondes enthaltenden Server Steuer Elements hinzu.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. Alle HTML-Tags oder Text Zeichenfolgen, die nicht auf dem Server verarbeitet werden, werden als LiteralControl Objekte behandelt.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. Diese werden wie andere Server Steuerelemente der Auflistung hinzugefügt.These are added to the collection like other server controls.

Die Controls-Eigenschaft ermöglicht den programmgesteuerten Zugriff auf die Instanz der ControlCollection-Klasse für ein beliebiges Server Steuerelement.The Controls property allows you programmatic access to the instance of the ControlCollection class for any server control. Sie können der Auflistung Steuerelemente hinzufügen, Steuerelemente aus der Auflistung entfernen oder die Server Steuerelemente in der Auflistung durchlaufen.You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.

Notes to Inheritors

Wenn Sie die Controls-Eigenschaft überschreiben, achten Sie darauf, die EnsureChildControls()-Methode aufzurufen.When overriding the Controls property, be sure to call the EnsureChildControls() method. Wenn Sie ferner planen, der Steuerelement Auflistung Programm gesteuert Steuerelemente hinzuzufügen, sollten Sie die Steuerelemente in einer überschriebenen CreateChildControls() Methode hinzufügen.Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls() method.

Applies to

See also