ControlCollection.Clear Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

public:
 virtual void Clear();

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

Beispiele

Im folgenden Codebeispiel wird die Methode außer Control.CreateChildControls Kraft gesetzt und Clear die Methode verwendet, um alle untergeordneten Steuerelemente zuvor im ControlCollection Objekt zu löschen. In diesem Fall müssen Sie dies ControlCollection tun, damit veraltete Objekte in Ihrem Steuerelement nicht unangemessen angezeigt werden.

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

Hinweise

Verwenden Sie diese Methode, um das benutzerdefinierte Steuerelement ControlCollection zu leeren, wenn Sie die Control.CreateChildControls Methoden DataBind außer Kraft setzen. Führen Sie dies aus, wenn Sie zusammengesetzte, vorlagenbasierte Steuerelemente oder vorlagengebundene Datensteuerelemente entwickeln.

Siehe auch

• Controls