Control.HasControls-Methode

Artikel
08/20/2007

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Function HasControls As Boolean
'Usage
Dim instance As Control
Dim returnValue As Boolean

returnValue = instance.HasControls

public virtual bool HasControls ()

public:
virtual bool HasControls ()

public boolean HasControls ()

public function HasControls () : boolean

Rückgabewert

true, wenn das Steuerelement andere Steuerelemente enthält, andernfalls false.

Hinweise

Da diese Methode einfach ermittelt, ob untergeordnete Steuerelemente vorhanden sind, kann eine Leistungssteigerung erzielt werden, indem ein unnötiger Aufruf der Count-Eigenschaft vermieden werden kann. Für Aufrufe dieser Eigenschaft muss ein ControlCollection-Objekt instanziiert werden. Wenn keine untergeordneten Elemente vorhanden sind, verschwendet diese Objekterstellung Serverressourcen.

Hinweise für Erben Die HasControls-Methode sollte nur überschrieben werden, um Metadatenattribute, z. B. EditorBrowsableAttribute, zu ändern. Weitere Informationen zum Verwenden von Attributen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Beispiel

Im folgenden Beispiel wird mithilfe der HasControls-Methode ermittelt, ob Steuerelemente vorhanden sind, bevor mit der Count-Eigenschaft ein ControlCollection-Objekt durchlaufen wird.

If HasControls() Then
    Dim i As Integer
    For i = 0 To Controls.Count - 1
        Controls(i).RenderControl(writer)
    Next i
End If

if (HasControls()) {
                 for (int i=0; i < Controls.Count; i++) {
                     Controls[i].RenderControl(writer);
                 }
   }

if (HasControls()) {
    for (int i = 0; i < get_Controls().get_Count(); i++) {
        get_Controls().get_Item(i).RenderControl(writer);
    }
}

if (HasControls()) {
                 for (var i : int = 0; i < Controls.Count; i++) {
                     Controls[i].RenderControl(writer);
                 }
   }

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
Controls
ControlCollection

Freigeben über