Collection.Remove, méthode (String)

Article
08/21/2007

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

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Sub Remove ( _
    Key As String _
)
'Utilisation
Dim instance As Collection
Dim Key As String

instance.Remove(Key)

public void Remove (
    string Key
)

public:
void Remove (
    String^ Key
)

public void Remove (
    String Key
)

public function Remove (
    Key : String
)

Paramètres

Key
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.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Remove, méthode (objet Collection).

Lorsque Remove supprime un élément d'une collection, il décrémente Count, propriété (objet Collection) de la collection d'une unité. Il décrémente également la valeur Index de chaque élément qui suivait 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.

Exemple

Cet exemple illustre l'utilisation de la méthode Remove pour supprimer les objets d'une Collection, objet (Visual Basic) 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")

À la suite des quatre appels à la méthode Add, la propriété Count contient 4, l'élément "Bill" a la valeur d'index 1 et l'élément "Pete" a la valeur d'index 4.

À la suite du premier appel à Remove, Count est 3, l'élément "Bill" est supprimé et l'élément "Pete" a la valeur d'index 3.

À la suite du deuxième appel à Remove, Count est 2, l'élément "Mike" est supprimé et l'élément "Pete" a la valeur d'index 2.

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Collection, classe
Membres Collection
Microsoft.VisualBasic, espace de noms

Autres ressources

Remove, méthode (objet Collection)
Collection, objet (Visual Basic)
Add, méthode (objet Collection)

Partager via