Collection.Contains, méthode

Article
08/21/2007

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

Retourne une valeur Boolean indiquant si un objet Visual Basic Collection contient un élément avec une clé spécifique.

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

Syntaxe

'Déclaration
Public Function Contains ( _
    Key As String _
) As Boolean
'Utilisation
Dim instance As Collection
Dim Key As String
Dim returnValue As Boolean

returnValue = instance.Contains(Key)

public bool Contains (
    string Key
)

public:
bool Contains (
    String^ Key
)

public boolean Contains (
    String Key
)

public function Contains (
    Key : String
) : boolean

Paramètres

Key
Obligatoire. Une expression String qui spécifie la clé à rechercher dans les éléments de la collection.

Valeur de retour

Retourne une valeur Boolean indiquant si un objet Visual Basic Collection contient un élément avec une clé spécifique.

Notes

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

Contains retourne True si la collection contient un élément avec une clé correspondant exactement à Key. Sinon, Contains retourne False.

Une Collection Visual Basic peut contenir certains éléments qui ont des clés et d'autres éléments qui n'en ont pas. Cela dépend de si l'appel à Add, méthode (objet Collection) fournit un argument au paramètre Key facultatif.

Exemple

Dim customers As New Microsoft.VisualBasic.Collection()
Dim accountNumber As String = "1234"
' Insert code that obtains new customer objects.
' Use the new customer's account number as the key.
customers.Add(newCustomer, accountNumber)
' The preceding statements can be repeated for several customers.
Dim searchNumber As String = "1234"
' Insert code to obtain an account number to search for.
If customers.Contains(searchNumber) Then
    MsgBox("The desired customer is in the collection.")
Else
    MsgBox("The desired customer is not in the collection.")
End If

Si vous projetez de rechercher des éléments dans la collection à l'aide de leurs clés, n'oubliez pas de fournir l'argument Key à chaque fois que vous appelez la méthode Add.

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

.NET Compact Framework

Prise en charge dans : 2.0

Voir aussi

Référence

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

Autres ressources

Contains, méthode (objet Collection)
Collection, objet (Visual Basic)
Item, propriété (objet Collection)
Count, propriété (objet Collection)
Add, méthode (objet Collection)
Remove, méthode (objet Collection)
Clear, méthode (objet Collection)

Partager via