Freigeben über


Remove-Methode (Collection-Objekt)

Aktualisiert: November 2007

Entfernt ein Element aus einem Collection-Objekt.

Public Overloads Sub Remove(_
    ByVal { Key As String | Index As Integer } _
)

Parameter

  • Key
    Ein eindeutiger String-Ausdruck, der eine Schlüsselzeichenfolge angibt, die anstelle eines Positionsindexes verwendet wird, um auf ein Element der Auflistung zuzugreifen. Key muss dem Key-Argument entsprechen, das beim Hinzufügen des Elements zur Auflistung angegeben wurde.

  • Index
    Ein numerischer Ausdruck, der die Position eines Elements der Auflistung angibt. Index muss eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft (Collection-Objekt) der Auflistung sein.

Ausnahmen

Ausnahmetyp

Fehlernummer

Bedingung

ArgumentException

5

Key ist ungültig oder wurde nicht angegeben.

IndexOutOfRangeException

9

Index stimmt mit keinem bereits vorhandenen Element der Auflistung überein.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Wenn Remove ein Element aus einer Auflistung löscht, wird die Count-Eigenschaft (Collection-Objekt) der Auflistung um eins verringert. Verringert wird auch der Index-Wert jedes Elements, das dem gelöschten Element zuvor in der Auflistung folgte.

Wenn der Auflistung ein Element ohne Key-Angabe hinzugefügt wurde, müssen Sie es anhand seines Index-Werts entfernen.

Beispiel

In diesem Beispiel wird veranschaulicht, wie mithilfe der Remove-Methode Objekte aus einem Collection-Objekt (Visual Basic) in der birthdays-Variablen entfernt werden.

Dim birthdays As New Collection()
birthdays.Add(New DateTime(2001, 1, 12), "Bill")
birthdays.Add(New DateTime(2001, 1, 13), "Joe")
birthdays.Add(New DateTime(2001, 1, 14), "Mike")
birthdays.Add(New DateTime(2001, 1, 15), "Pete")


...


birthdays.Remove(1)
birthdays.Remove("Mike")

Nach den vier Aufrufen der Add-Methode enthält die Count-Eigenschaft den Wert 4, das Element "Bill" hat den Indexwert 1, und das Element "Pete" hat den Indexwert 4.

Nach dem ersten Aufruf von Remove ist Count gleich 3, Element "Bill" wurde gelöscht, und Element "Pete" hat den Indexwert 3.

Nach dem zweiten Aufruf von Remove ist Count gleich 2, das Element "Mike" wurde gelöscht, und das Element "Pete" hat den Indexwert 2.

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**Collection

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Referenz

Collection-Objekt (Visual Basic)

Add-Methode (Collection-Objekt)