Collection.Contains(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Um valor que indica se um objeto Collection
do Visual Basic contém um elemento com uma chave específica.
public:
bool Contains(System::String ^ Key);
public bool Contains (string Key);
member this.Contains : string -> bool
Public Function Contains (Key As String) As Boolean
Parâmetros
- Key
- String
Obrigatórios. Uma expressão String
que especifica a chave pela qual pesquisar os elementos da coleção.
Retornos
true
se um objeto Collection
do Visual Basic contém um elemento com uma chave específica; caso contrário, false
.
Exemplos
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
Se você pretende pesquisar elementos na coleção usando suas chaves, lembre-se de fornecer o Key
argumento sempre que chamar o Add
método.
Comentários
Contains
retornará True
se a coleção contiver um elemento com uma chave que corresponde Key
exatamente a . Caso contrário, Contains
retornará False
. Maiúsculas e minúsculas são ignoradas ao corresponder valores de chave.
Um Visual Basic Collection
pode conter alguns elementos que têm chaves e outros elementos sem chaves. Isso depende se a chamada para o Add método fornece um argumento para o parâmetro opcional Key
.