Collection.Remove Méthode

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Supprime un élément d'un objet Collection.

Surcharges

Remove(Int32)	Supprime un élément d'un objet Collection.
Remove(String)	Supprime un élément d'un objet Collection.

Remove(Int32)

Source:

Collection.vb

Supprime un élément d'un objet Collection.

public:
 void Remove(int Index);

public void Remove (int Index);

member this.Remove : int -> unit

Public Sub Remove (Index As Integer)

Paramètres

Index

Int32

Expression numérique qui spécifie la position d'un élément de la collection. Index doit être un nombre compris entre 1 et la valeur de la propriété Count de la collection.

Exemples

Cet exemple illustre l’utilisation de la Remove méthode pour supprimer des objets d’un Collection objet dans la 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")

Après les quatre appels à la Add méthode, la Count propriété contient 4, l’élément "Bill" a la valeur d’index 1 et l’élément "Pete" a la valeur d’index 4.

Après le premier appel à Remove, Count a la valeur 3, l’élément "Bill" est supprimé et l’élément "Pete" a la valeur d’index 3.

Après le deuxième appel à Remove, Count a la valeur 2, l’élément "Mike" est supprimé et l’élément "Pete" a la valeur d’index 2.

Remarques

Lorsque Remove supprime un élément d’une collection, la propriété de la collection est Count décrémentée d’un. Il décrémente également la Index valeur de chaque élément qui a suivi auparavant l’élément supprimé dans la collection.

Si un élément a été ajouté à la collection sans Key, vous devez utiliser son Index pour le supprimer.

Remove(String)

Source:

Collection.vb

Supprime un élément d'un objet Collection.

public:
 void Remove(System::String ^ Key);

public void Remove (string Key);

member this.Remove : string -> unit

Public Sub Remove (Key As String)

Paramètres

Key

String

Expression String unique qui spécifie une chaîne clé qui peut être utilisée au lieu d'un index de position pour accéder à un élément de la collection. Key doit correspondre à l'argument Key spécifié lorsque l'élément a été ajouté à la collection.

Exemples

Cet exemple illustre l’utilisation de la Remove méthode pour supprimer des objets d’un Collection objet dans la 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")

Après les quatre appels à la Add méthode, la Count propriété contient 4, l’élément "Bill" a la valeur d’index 1 et l’élément "Pete" a la valeur d’index 4.

Après le premier appel à Remove, Count a la valeur 3, l’élément "Bill" est supprimé et l’élément "Pete" a la valeur d’index 3.

Après le deuxième appel à Remove, Count a la valeur 2, l’élément "Mike" est supprimé et l’élément "Pete" a la valeur d’index 2.

Remarques

Lorsque Remove supprime un élément d’une collection, la propriété de la collection est Count décrémentée d’un. Il décrémente également la Index valeur de chaque élément qui a suivi auparavant l’élément supprimé dans la collection.

Si un élément a été ajouté à la collection sans Key, vous devez utiliser son Index pour le supprimer.