Control.Controls-Eigenschaft
Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Overridable ReadOnly Property Controls As ControlCollection
'Usage
Dim instance As Control
Dim value As ControlCollection
value = instance.Controls
public virtual ControlCollection Controls { get; }
public:
virtual property ControlCollection^ Controls {
ControlCollection^ get ();
}
/** @property */
public ControlCollection get_Controls ()
public function get Controls () : ControlCollection
Eigenschaftenwert
Die Auflistung der untergeordneten Steuerelemente für das angegebene Serversteuerelement.
Hinweise
Wenn auf einer ASP.NET-Seite Steuerelemente innerhalb der öffnenden und schließenden Tags eines Serversteuerelements deklarativ eingefügt werden, fügt ASP.NET die Steuerelemente automatisch der ControlCollection des enthaltenden Serversteuerelements hinzu. Alle HTML-Tags oder Textzeichenfolgen, die nicht vom Server verarbeitet werden, werden als LiteralControl-Objekte behandelt. Diese werden der Auflistung wie andere Serversteuerelemente hinzugefügt.
Mit der Controls-Eigenschaft kann programmgesteuert auf die Instanz der ControlCollection-Klasse jedes Serversteuerelements zugegriffen werden. In der Auflistung können Sie Steuerelemente hinzufügen oder entfernen, oder Sie können die in der Auflistung enthaltenen Serversteuerelemente durchlaufen.
Hinweise für Erben Wenn Sie die Controls-Eigenschaft überschreiben, stellen Sie sicher, dass die EnsureChildControls-Methode aufgerufen wird. Wenn Sie der Steuerelementauflistung außerdem programmgesteuert Steuerelemente hinzuzufügen möchten, bietet es sich an, die Steuerelemente einer überschriebenen CreateChildControls-Methode hinzuzufügen.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie dem ControlCollection-Objekt eines Serversteuerelements über dessen Controls-Eigenschaft untergeordnete Steuerelemente hinzugefügt werden.
Controls.Add(New LiteralControl("<h3>Value: "))
Controls.Add(new LiteralControl("<h3>Value: "));
get_Controls().Add(new LiteralControl("<h3>Value: "));
Controls.Add(new LiteralControl("<h3>Value: "));
pt]
this.Controls.Add(new LiteralControl("<h3>Value: "));
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Control-Klasse
Control-Member
System.Web.UI-Namespace
ControlCollection
CreateControlCollection
CreateChildControls