Control.Controls Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie 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.ControlCollectionPublic Overridable ReadOnly Property Controls As ControlCollectionEigenschaftswert
Die Auflistung der untergeordneten Steuerelemente für das angegebene Serversteuerelement.
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie sie dem Objekt eines Serversteuerelements ControlCollection über seine Controls Eigenschaft untergeordnete Steuerelemente 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, ASP.NET die Steuerelemente automatisch zu den enthaltenden Serversteuerelementen ControlCollectionhinzufügen. 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 die Serversteuerelemente in der Auflistung durchlaufen.
Hinweise für Vererber
Achten Sie beim Überschreiben der Controls Eigenschaft darauf, die EnsureChildControls() Methode aufzurufen. Wenn Sie planen, der Steuerelementsammlung programmgesteuert Steuerelemente hinzuzufügen, sollten Sie die Steuerelemente in einer überschriebenen CreateChildControls() Methode hinzufügen.
