ControlCollection.Clear-Methode

Artikel
08/20/2007

Entfernt sämtliche Steuerelemente aus dem ControlCollection-Objekt des aktuellen Serversteuerelements.

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

Syntax

'Declaration
Public Overridable Sub Clear
'Usage
Dim instance As ControlCollection

instance.Clear

public virtual void Clear ()

public:
virtual void Clear ()

public void Clear ()

public function Clear ()

Hinweise

Mithilfe dieser Methode wird die ControlCollection eines benutzerdefinierten Steuerelements geleert, wenn die Control.CreateChildControls-Methode und die DataBind-Methode überschrieben werden. Dies empfiehlt sich für die Entwicklung von aus Vorlagen gebildeten zusammengesetzten oder datengebundenen Steuerelementen.

Beispiel

Im folgenden Codebeispiel wird das Überschreiben der Control.CreateChildControls-Methode und das Löschen aller ehemaligen untergeordneten Steuerelemente des ControlCollection-Objekts mithilfe der Clear-Methode veranschaulicht. Dies ist hier erforderlich, damit keine veralteten Objekte aus der ControlCollection des Steuerelements angezeigt werden.

' Override to create repeated items.
Protected Overrides Sub CreateChildControls()
    Dim O As Object = ViewState("NumItems")
    If Not (O Is Nothing)
       ' Clear any existing child controls.
       Controls.Clear()

       Dim I As Integer
       Dim NumItems As Integer = CInt(O)
       For I = 0 To NumItems - 1
          ' Create an item.
          Dim Item As RepeaterItemVB = New RepeaterItemVB(I, Nothing)
          ' Initialize the item from the template.
          ItemTemplate.InstantiateIn(Item)
          ' Add the item to the ControlCollection.
          Controls.Add(Item)
       Next
    End If
End Sub

// Override to create repeated items.
protected override void CreateChildControls() {
    object o = ViewState["NumItems"];
    if (o != null) {
       // Clear any existing child controls.
       Controls.Clear();

       int numItems = (int)o;
       for (int i=0; i < numItems; i++) {
          // Create an item.
          RepeaterItem item = new RepeaterItem(i, null);
          // Initialize the item from the template.
          ItemTemplate.InstantiateIn(item);
          // Add the item to the ControlCollection.
          Controls.Add(item);
       }
    }
}

// Override to create repeated items.
protected void CreateChildControls()
{
    Object o = get_ViewState().get_Item("NumItems");
    if (o != null) {
        // Clear any existing child controls.
        get_Controls().Clear();

        int numItems = Convert.ToInt32(o);
        for (int i = 0; i < numItems; i++) {
            // Create an item.
            RepeaterItem item = new RepeaterItem(i, null);
            // Initialize the item from the template.
            get_ItemTemplate().InstantiateIn(item);
            // Add the item to the ControlCollection.
            get_Controls().Add(item);
        }
    }
} //CreateChildControls

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

ControlCollection-Klasse
ControlCollection-Member
System.Web.UI-Namespace
Control.Controls-Eigenschaft

Freigeben über