Freigeben über


Control.Controls Eigenschaft

Definition

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.

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; }
[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

Eigenschaftswert

ControlCollection

Die Auflistung der untergeordneten Steuerelemente für das angegebene Serversteuerelement.

Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie untergeordnete Steuerelemente über die Controls Eigenschaft eines Serversteuerelements ControlCollection zu einem Serversteuerelement hinzufügen.

Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(New LiteralControl("<h3>Value: "))
  

Hinweise

Wenn Steuerelemente auf einer ASP.NET Seite deklarativ zwischen den öffnenden und schließenden Tags eines Serversteuerelements hinzugefügt werden, fügt ASP.NET die Steuerelemente automatisch dem enthaltenden Serversteuerelement ControlCollectionhinzu. Alle HTML-Tags oder Textzeichenfolgen, die nicht auf dem Server verarbeitet werden, werden als LiteralControl Objekte behandelt. Diese werden der Auflistung wie anderen Serversteuerelementen hinzugefügt.

Die Controls Eigenschaft ermöglicht Den programmgesteuerten Zugriff auf die Instanz der ControlCollection Klasse für jedes Serversteuerelement. Sie können der Auflistung Steuerelemente hinzufügen, Steuerelemente aus der Auflistung entfernen oder über die Serversteuerelemente in der Auflistung iterieren.

Hinweise für Vererber

Wenn Sie die Controls Eigenschaft außer Kraft setzen, müssen Sie die EnsureChildControls() Methode aufrufen. Wenn Sie außerdem die Steuerelemente programmgesteuert zur Steuerelementsammlung hinzufügen möchten, sollten Sie die Steuerelemente in einer überschriebenen CreateChildControls() Methode hinzufügen.

Gilt für

Siehe auch