Control.ControlCollection.Remove(Control) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

Control.ControlCollection.cs

Belirtilen denetimi denetim koleksiyonundan kaldırır.

public:
 virtual void Remove(System::Windows::Forms::Control ^ value);

public virtual void Remove(System.Windows.Forms.Control? value);

abstract member Remove : System.Windows.Forms.Control -> unit
override this.Remove : System.Windows.Forms.Control -> unit

Public Overridable Sub Remove (value As Control)

Parametreler

value

Control

Control' den kaldırılacak .Control.ControlCollection

Örnekler

Aşağıdaki kod örneği, koleksiyonun bir üyesiyse türetilen sınıfın Control öğesinden Control.ControlCollection bir Panel öğesini kaldırır. Örnek, üzerinde bir Panel, ve bir Buttonveya daha fazla RadioButton denetim Formoluşturmanızı gerektirir. Denetimler RadioButton denetimine Panel , Panel denetim ise öğesine Formeklenir. Düğmeye tıklandığında, adlı radioButton2 radyo düğmesi öğesinden Control.ControlCollectionkaldırılır.

   // Remove the RadioButton control if it exists.
private:
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( panel1->Controls->Contains( removeButton ) )
      {
         panel1->Controls->Remove( removeButton );
      }
   }

// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}

' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveButton.Click
    If Panel1.Controls.Contains(RemoveButton) Then
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

Açıklamalar

bir Control denetim koleksiyonundan kaldırıldığında, sonraki tüm denetimler koleksiyonda bir konum yukarı taşınır.

Yöntemini kullanarak Control da öğesini RemoveAt kaldırabilir veya yöntemini kullanarak Clear tüm denetimleri kaldırabilirsiniz.

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

Devralanlara Notlar

Türetilmiş bir sınıfta geçersiz kıldığınızda Remove(Control) , denetimin koleksiyondan kaldırıldığından emin olmak için temel sınıfın Remove(Control) yöntemini çağırdığınızdan emin olun.

Ayrıca bkz.

• RemoveAt(Int32)
• Clear()
• Add(Control)