ControlCollection.Clear Método

Definición

Quita todos los controles del objeto ControlCollection del control de servidor actual.Removes all controls from the current server control's ControlCollection object.

public:
 virtual void Clear();
public virtual void Clear ();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Overridable Sub Clear ()

Ejemplos

En el ejemplo de código siguiente se muestra cómo invalidar el Control.CreateChildControls método y cómo usar el Clear método para eliminar todos los controles secundarios anteriormente en el ControlCollection objeto.The following code example demonstrates overriding the Control.CreateChildControls method, and using the Clear method to delete all child controls previously in the ControlCollection object. En este caso, debe hacer esto para que los objetos obsoletos del control ControlCollection no se muestren de forma inapropiada.In this case, you must do this so that outdated objects in your control's ControlCollection are not displayed inappropriately.

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

Comentarios

Utilice este método para vaciar un control personalizado ControlCollection cuando invalide Control.CreateChildControls los DataBind métodos y.Use this method to empty a custom control's ControlCollection when you override the Control.CreateChildControls and DataBind methods. Hágalo cuando desarrolle controles compuestos, con plantilla o controles enlazados a datos con plantilla.Do this when you develop composite, templated controls or templated data-bound controls.

Se aplica a

Consulte también