Control.ControlCollection.RemoveAt-Methode

Entfernt ein Steuerelement an der angegebenen indizierten Position aus der Steuerelementauflistung.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Sub RemoveAt ( _
    index As Integer _
)
'Usage
Dim instance As ControlCollection
Dim index As Integer

instance.RemoveAt(index)

public void RemoveAt (
    int index
)

public:
virtual void RemoveAt (
    int index
) sealed

public final void RemoveAt (
    int index
)

public final function RemoveAt (
    index : int
)

Parameter

• index
  Der Indexwert des zu entfernenden Control.

Hinweise

Wenn ein Control aus der Steuerelementauflistung entfernt wird, werden alle nachfolgenden Steuerelemente um eine Position in der Auflistung nach oben verschoben.

Sie können ein zuvor hinzugefügtes Control auch mithilfe der Remove-Methode oder der Clear-Methode entfernen.

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

Beispiel

Im folgenden Codebeispiel wird das erste Control in der Control.ControlCollection vom Panel der abgeleiteten Klasse entfernt, wenn der Zähler der Auflistung größer als 0 (null) ist. Im Beispiel wird davon ausgegangen, dass ein Panel, ein Button und mindestens ein anderes Steuerelement in einem Form erstellt wurden. Die anderen Steuerelemente werden dem Panel-Steuerelement hinzugefügt, und das Panel-Steuerelement wird dem Form hinzugefügt. Beim Klicken auf die Schaltfläche wird das erste im Bereich enthaltene Steuerelement aus der Control.ControlCollection entfernt.

' 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

// 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 void removeAtButton_Click(Object sender, System.EventArgs e)
{
    if (panel1.get_Controls().get_Count() > 0) {
        panel1.get_Controls().RemoveAt(0);
    }
} //removeAtButton_Click

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control.ControlCollection-Klasse
Control.ControlCollection-Member
System.Windows.Forms-Namespace
Remove
Clear
Add