Control.Controls-Eigenschaft

public virtual ControlCollection Controls { get; }

/** @property */
public ControlCollection get_Controls ()

public function get Controls () : ControlCollection

Eigenschaftenwert

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.

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: "));

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

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

pt]
this.Controls.Add(new LiteralControl("<h3>Value: "));
   

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.

.NET Framework