Control.ControlCollection.Clear Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

Control.ControlCollection.cs

Koleksiyondaki tüm denetimleri kaldırır.

public:
 virtual void Clear();

public virtual void Clear();

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

Public Overridable Sub Clear ()

Uygulamalar

Clear()

Örnekler

Aşağıdaki kod örneği, türetilmiş sınıfındaki ControlControl.ControlCollectiontüm Panel nesneleri kaldırır. Örnek, üzerinde bir Panel, ve en az bir Buttondenetim Formdaha oluşturmanızı gerektirir. Diğer denetimler denetime Panel eklenir ve Panel öğesine eklenir Form. Düğmeye tıklandığında, panelde yer alan tüm denetimler öğesinden Control.ControlCollectionkaldırılır.

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

Açıklamalar

Bir üst denetimden denetim koleksiyonunun tamamını kaldırmak için yöntemini kullanabilirsiniz Clear .

Tek bir denetimi koleksiyondan kaldırmak için veya Remove yöntemlerini kullanınRemoveAt.

Important

yöntemini çağırmak Clear , denetim tutamaçlarını bellekten kaldırmaz. Bellek sızıntılarını Dispose önlemek için yöntemini açıkça çağırmanız gerekir.

Koleksiyona yeni Control nesneler eklemek için veya Add yöntemlerini kullanınAddRange.

Devralanlara Notlar

Türetilmiş bir sınıfta geçersiz kılma Clear() sırasında, tüm denetimlerin koleksiyondan kaldırıldığından emin olmak için temel sınıfın Clear() yöntemini çağırdığınızdan emin olun.