Freigeben über


Control.ControlCollection.RemoveAt(Int32) Methode

Definition

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

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:

Weitere Informationen