ControlCollection.Clear Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tar bort alla kontroller från den aktuella serverkontrollens ControlCollection objekt.
public:
virtual void Clear();
public virtual void Clear();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Overridable Sub Clear ()
Exempel
Följande kodexempel visar hur du åsidosättar Control.CreateChildControls metoden och använder Clear metoden för att ta bort alla underordnade kontroller som tidigare fanns i ControlCollection objektet. I det här fallet måste du göra detta så att inaktuella objekt i kontrollen inte ControlCollection visas på ett olämpligt sätt.
// 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
Kommentarer
Använd den här metoden för att tömma en anpassad kontroll när du åsidosätter ControlCollectionControl.CreateChildControls metoderna och DataBind . Gör detta när du utvecklar sammansatta, mallade kontroller eller mallade databundna kontroller.