Control.ControlCollection.Remove(Control) Methode

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)

Parameter

Beispiele

Im folgenden Codebeispiel wird eine Control aus der Control.ControlCollection abgeleiteten Klasse Panel entfernt, wenn es sich um ein Element der Auflistung handelt. Das Beispiel erfordert, dass Sie ein Panel, a Buttonund mindestens ein RadioButton Steuerelement für ein .Form Die RadioButton Steuerelemente werden dem Panel Steuerelement hinzugefügt, und das Panel Steuerelement wird dem FormSteuerelement hinzugefügt. Wenn auf die Schaltfläche geklickt wird, wird das Optionsfeld mit dem Namen radioButton2 aus der Control.ControlCollectionSchaltfläche entfernt.

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

Hinweise

Wenn ein Steuerelement Control aus der Steuerelementsammlung entfernt wird, werden alle nachfolgenden Steuerelemente an einer Position in der Auflistung nach oben verschoben.

Sie können ein Control Element auch mithilfe der RemoveAt Methode entfernen oder alle Steuerelemente mithilfe der Clear Methode entfernen.

Wenn Sie der Auflistung neue Control Objekte hinzufügen möchten, verwenden Sie die Add oder AddRange die Methoden.

Hinweise für Vererber

Achten Sie beim Überschreiben Remove(Control) in einer abgeleiteten Klasse darauf, die Methode der Basisklasse Remove(Control) aufzurufen, um sicherzustellen, dass das Steuerelement aus der Auflistung entfernt wird.

Weitere Informationen

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