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 |
|---|---|---|
Key ist ungültig oder wurde nicht angegeben. |
||
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)