Control.Controls Control.Controls Control.Controls 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

Eigenschaftswert

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie dem- ControlCollection Objekt eines Server Steuer Elements über seine Controls -Eigenschaft untergeordnete Steuerelemente hinzugefügt werden.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: "))
  

Hinweise

Wenn auf einer ASP.net- ControlCollectionSeite Steuerelemente zwischen dem öffnenden und dem schließenden Tag eines Server Steuer Elements deklarativ hinzugefügt werden, werden die Steuerelemente von ASP.NET automatisch dem enthaltenden Server Steuerelement hinzugefügt.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 LiteralControl werden, werden als-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 ControlCollection der-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.

Hinweise für Vererber

Wenn Sie die Controls Eigenschaft überschreiben, stellen Sie sicher EnsureChildControls() , dass Sie die-Methode aufruft.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 ggf. die Steuerelemente CreateChildControls() in einer überschriebenen 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.

Gilt für:

Siehe auch