Control.ControlCollection.Clear Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

Control.ControlCollection.cs

Menghapus semua kontrol dari koleksi.

public:
 virtual void Clear();

public virtual void Clear();

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

Public Overridable Sub Clear ()

Penerapan

Clear()

Contoh

Contoh kode berikut menghapus semua Control objek di Control.ControlCollection kelas Panelturunan . Contoh mengharuskan Anda telah membuat Panel, , Buttondan setidaknya satu kontrol lain pada Form. Kontrol lain ditambahkan ke Panel kontrol, dan Panel ditambahkan ke Form. Ketika tombol diklik, semua kontrol yang terkandung dalam panel dihapus dari 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

Keterangan

Anda dapat menggunakan Clear metode untuk menghapus seluruh kumpulan kontrol dari kontrol induk.

Untuk menghapus kontrol individual dari koleksi, gunakan Remove metode atau RemoveAt .

Important

Memanggil Clear metode tidak menghapus handel kontrol dari memori. Anda harus secara eksplisit memanggil metode untuk menghindari kebocoran Dispose memori.

Untuk menambahkan objek baru Control ke koleksi, gunakan Add metode atau AddRange .

Catatan Bagi Inheritor

Saat mengambil alih kelas turunan Clear() , pastikan untuk memanggil metode kelas Clear() dasar untuk memastikan bahwa semua kontrol dihapus dari koleksi.