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