ControlCollection.Clear Metodo

Definizione

Rimuove tutti i controlli dall'oggetto ControlCollection del controllo server corrente.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 ()

Esempi

Nell'esempio di codice riportato di seguito viene Control.CreateChildControls illustrato come eseguire l'override Clear del metodo e come utilizzare il metodo per eliminare ControlCollection tutti i controlli figlio precedentemente presenti nell'oggetto.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. In questo caso, è necessario eseguire questa operazione in modo che gli oggetti obsoleti nel controllo ControlCollection non vengano visualizzati in modo non appropriato.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

Commenti

Utilizzare questo metodo per svuotare un controllo ControlCollection personalizzato quando si esegue l'override dei Control.CreateChildControls metodi e DataBind .Use this method to empty a custom control's ControlCollection when you override the Control.CreateChildControls and DataBind methods. Eseguire questa operazione quando si sviluppano controlli compositi, basati su modelli o controlli con associazione a dati basati su modelli.Do this when you develop composite, templated controls or templated data-bound controls.

Si applica a

Vedi anche