Control.ControlCollection.Clear Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

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ının Paneliçindeki tüm Control nesneleri Control.ControlCollection kaldırır. Örnek, üzerinde bir Panel, bir ve en az bir Buttondenetim Formdaha oluşturmanızı gerektirir. Diğer denetimler denetime Panel eklenir ve Panel denetimine Formeklenir. 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 .

Koleksiyondan tek bir denetimi kaldırmak için veya RemoveAt yöntemlerini kullanınRemove.

Önemli

yöntemi çağrılırsa Clear bellekten denetim tanıtıcıları kaldırılmaz. Bellek sızıntılarını önlemek için yöntemini açıkça çağırmanız Dispose gerekir.

Koleksiyona yeni Control nesneler eklemek için veya AddRange yöntemlerini kullanınAdd.

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.