Collection.Remove Methode

Definition

Entfernt ein Element aus einem Collection-Objekt.Removes an element from a Collection object.

Überlädt

Remove(Int32)

Entfernt ein Element aus einem Collection-Objekt.Removes an element from a Collection object.

Remove(String)

Entfernt ein Element aus einem Collection-Objekt.Removes an element from a Collection object.

Remove(Int32)

Entfernt ein Element aus einem Collection-Objekt.Removes an element from a Collection object.

public:
 void Remove(int Index);
public void Remove (int Index);
member this.Remove : int -> unit
Public Sub Remove (Index As Integer)

Parameter

Index
Int32

Ein numerischer Ausdruck, der die Position eines Elements der Auflistung angibt.A numeric expression that specifies the position of an element of the collection. Index muss eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft der Auflistung sein.Index must be a number from 1 through the value of the collection's Count property.

Beispiele

In diesem Beispiel wird die Verwendung der- Remove Methode zum Entfernen von Objekten aus einem- Collection Objekt in der-Variable veranschaulicht birthdays .This example illustrates the use of the Remove method to remove objects from a Collection object in the variable birthdays.

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 4, das "Bill" -Element den Indexwert 1 und das-Element den "Pete" Indexwert 4.Following the four calls to the Add method, the Count property contains 4, element "Bill" has index value 1, and element "Pete" has index value 4.

Nach dem ersten-Aufrufe Remove von Count ist 3, das "Bill" -Element wird gelöscht, und das-Element "Pete" weist den Indexwert 3 auf.Following the first call to Remove, Count is 3, element "Bill" is deleted, and element "Pete" has index value 3.

Nach dem zweiten-Aufrufe Remove von Count ist 2, das "Mike" -Element wird gelöscht, und das-Element "Pete" hat den Indexwert 2.Following the second call to Remove, Count is 2, element "Mike" is deleted, and element "Pete" has index value 2.

Hinweise

Wenn Remove ein Element aus einer Auflistung löscht, wird die-Eigenschaft der Auflistung Count um eins verringert.When Remove deletes an element from a collection, it decrements the collection's Count property by one. Außerdem wird der Index Wert jedes Elements, das zuvor dem gelöschten Element in der Auflistung folgte, verringert.It also decrements the Index value of every element that formerly followed the deleted element in the collection.

Wenn der Auflistung ein Element ohne hinzugefügt wurde Key , müssen Sie das-Element verwenden, Index um es zu entfernen.If an element was added to the collection without a Key, you must use its Index to remove it.

Gilt für:

Remove(String)

Entfernt ein Element aus einem Collection-Objekt.Removes an element from a Collection object.

public:
 void Remove(System::String ^ Key);
public void Remove (string Key);
member this.Remove : string -> unit
Public Sub Remove (Key As String)

Parameter

Key
String

Ein eindeutiger String-Ausdruck, der eine Schlüsselzeichenfolge angibt, die anstelle eines Positionsindex verwendet werden kann, um auf ein Element der Auflistung zuzugreifen.A unique String expression that specifies a key string that can be used, instead of a positional index, to access an element of the collection. Key muss dem Key-Argument entsprechen, das beim Hinzufügen des Elements zur Auflistung angegeben wurde.Key must correspond to the Key argument specified when the element was added to the collection.

Beispiele

In diesem Beispiel wird die Verwendung der- Remove Methode zum Entfernen von Objekten aus einem- Collection Objekt in der-Variable veranschaulicht birthdays .This example illustrates the use of the Remove method to remove objects from a Collection object in the variable birthdays.

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 4, das "Bill" -Element den Indexwert 1 und das-Element den "Pete" Indexwert 4.Following the four calls to the Add method, the Count property contains 4, element "Bill" has index value 1, and element "Pete" has index value 4.

Nach dem ersten-Aufrufe Remove von Count ist 3, das "Bill" -Element wird gelöscht, und das-Element "Pete" weist den Indexwert 3 auf.Following the first call to Remove, Count is 3, element "Bill" is deleted, and element "Pete" has index value 3.

Nach dem zweiten-Aufrufe Remove von Count ist 2, das "Mike" -Element wird gelöscht, und das-Element "Pete" hat den Indexwert 2.Following the second call to Remove, Count is 2, element "Mike" is deleted, and element "Pete" has index value 2.

Hinweise

Wenn Remove ein Element aus einer Auflistung löscht, wird die-Eigenschaft der Auflistung Count um eins verringert.When Remove deletes an element from a collection, it decrements the collection's Count property by one. Außerdem wird der Index Wert jedes Elements, das zuvor dem gelöschten Element in der Auflistung folgte, verringert.It also decrements the Index value of every element that formerly followed the deleted element in the collection.

Wenn der Auflistung ein Element ohne hinzugefügt wurde Key , müssen Sie das-Element verwenden, Index um es zu entfernen.If an element was added to the collection without a Key, you must use its Index to remove it.

Gilt für: