Collection.Contains(String) Méthode

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

Collection.vb

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

public:
 bool Contains(System::String ^ Key);

public bool Contains (string Key);

member this.Contains : string -> bool

Public Function Contains (Key As String) As Boolean

Paramètres

Key

String

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

Retours

Boolean

true si un objet Visual Basic Collection contient un élément avec une clé spécifique ; sinon false.

Exemples

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 envisagez 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 Add méthode.

Remarques

Contains retourne True si la collection contient un élément avec une clé correspondant exactement à Key. Sinon, Contains retourne False. La casse est ignorée lors de la correspondance des valeurs de clé.

Un Visual Basic Collection peut contenir certains éléments qui ont des clés et d’autres éléments sans clés. Cela dépend si l’appel à la Add méthode fournit un argument au paramètre facultatif Key .