ControlCollection.Clear Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Remove todos os controles do objeto ControlCollection do controle dde servidor atual.

public:
 virtual void Clear();

public virtual void Clear ();

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

Public Overridable Sub Clear ()

Exemplos

O exemplo de código a seguir demonstra a substituição do Control.CreateChildControls método e o uso do Clear método para excluir todos os controles filho anteriormente no ControlCollection objeto. Nesse caso, você deve fazer isso para que objetos desatualizados em seus controles ControlCollection não sejam exibidos inadequadamente.

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

Comentários

Use esse método para esvaziar os controles ControlCollection personalizados ao substituir os métodos e DataBind os Control.CreateChildControls métodos. Faça isso ao desenvolver controles compostos, modelos ou controles com limite de dados com modelo.

Confira também

• Controls