Control.ControlCollection.Remove(Control) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Entfernt das angegebene Steuerelement aus der Steuerelementauflistung.

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

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

value: Control

Der Control, der aus der Control.ControlCollection entfernt werden soll.

Beispiele

Im folgenden Codebeispiel wird ein 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-, ein Button- und ein oder RadioButton mehrere -Steuerelemente für eine Formerstellt haben. Die RadioButton Steuerelemente werden dem Panel -Steuerelement hinzugefügt, und das Panel -Steuerelement wird dem Formhinzugefügt. Wenn auf die Schaltfläche geklickt wird, wird das Optionsfeld namens radioButton2 aus der Control.ControlCollectionentfernt.

   // 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 Control aus der Steuerelementsammlung entfernt wird, werden alle nachfolgenden Steuerelemente um eine Position in der Auflistung nach oben verschoben.

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

Verwenden Sie Add die -Methode oderAddRange, um der Auflistung neue Control -Objekte hinzuzufügen.

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.

Gilt für:

Freigeben über