Control.ControlCollection.Clear Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Usuwa wszystkie kontrolki z kolekcji.

public:
 virtual void Clear();

public virtual void Clear ();

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

Public Overridable Sub Clear ()

Implementuje

Clear()

Przykłady

Poniższy przykład kodu usuwa wszystkie Control obiekty w Control.ControlCollection klasie Panelpochodnej . W przykładzie jest wymagane utworzenie kontrolki Panel, , i Buttonco najmniej jednej innej kontrolki w obiekcie Form. Pozostałe kontrolki są dodawane do kontrolki Panel i Panel dodawane do elementu Form. Po kliknięciu przycisku wszystkie kontrolki znajdujące się w panelu zostaną usunięte z elementu Control.ControlCollection.

   // Clear all the controls in the Panel.
private:
   void clearButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      panel1->Controls->Clear();
   }

// Clear all the controls in the Panel.
private void clearButton_Click(object sender, System.EventArgs e)
{
   panel1.Controls.Clear();
}

' Clear all the controls in the Panel.
Private Sub ClearButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles ClearButton.Click
    Panel1.Controls.Clear()
End Sub

Uwagi

Możesz użyć Clear metody , aby usunąć całą kolekcję kontrolek z kontrolki nadrzędnej.

Aby usunąć pojedynczą kontrolkę z kolekcji, użyj Remove metod lub RemoveAt .

Ważne

Clear Wywołanie metody nie powoduje usunięcia uchwytów sterujących z pamięci. Aby uniknąć przecieków pamięci, należy jawnie wywołać metodę Dispose .

Aby dodać nowe Control obiekty do kolekcji, użyj Add metod lub AddRange .

Uwagi dotyczące dziedziczenia

Podczas zastępowania Clear() w klasie pochodnej należy wywołać metodę klasy Clear() bazowej, aby upewnić się, że wszystkie kontrolki zostaną usunięte z kolekcji.