Control.ControlCollection.RemoveAt(Int32) 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 ein Steuerelement an der angegebenen indizierten Position aus der Steuerelementauflistung.

public:
 virtual void RemoveAt(int index);

public void RemoveAt (int index);

abstract member RemoveAt : int -> unit
override this.RemoveAt : int -> unit

Public Sub RemoveAt (index As Integer)

Parameter

index: Int32

Der Indexwert des zu entfernenden Control.

Implementiert

RemoveAt(Int32)

Beispiele

Im folgenden Codebeispiel wird die erste Control in der Control.ControlCollection der abgeleiteten Klasse Panel entfernt, wenn die Anzahl der Auflistung größer als 0 (null) ist. Das Beispiel erfordert, dass Sie ein Panel- , - Buttonund mindestens ein anderes -Steuerelement für einen Formerstellt haben. Die anderen Steuerelemente werden dem Panel -Steuerelement hinzugefügt, und das Panel -Steuerelement wird hinzugefügt Form. Wenn auf die Schaltfläche geklickt wird, wird das erste im Bereich enthaltene Steuerelement aus dem Control.ControlCollectionentfernt.

   // Remove the first control in the collection.
private:
   void removeAtButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( panel1->Controls->Count > 0 )
      {
         panel1->Controls->RemoveAt( 0 );
      }
   }

// Remove the first control in the collection.
private void removeAtButton_Click(object sender, System.EventArgs e)
{
   if (panel1.Controls.Count > 0)
   {
      panel1.Controls.RemoveAt(0);
   }
}

' Remove the first control in the collection.
Private Sub RemoveAtButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveAtButton.Click
    If (Panel1.Controls.Count > 0) Then
        Panel1.Controls.RemoveAt(0)
    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 eine Control entfernen, die Sie zuvor mit den Remove Methoden oder Clear hinzugefügt haben.

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

Gilt für:

Freigeben über