Collection.Contains(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um valor que indica se um objeto Visual Basic Collection 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
Required. Uma String expressão que especifica a chave para pesquisar os elementos da coleção.
Devoluções
true se Visual Basic Collection objeto contiver 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 pretende procurar elementos na coleção usando as suas chaves, lembre-se de fornecer o argumento Key sempre que chamar o Add método.
Observações
Contains retorna True se a coleção contiver um elemento cuja chave corresponde Keyexatamente a . Caso contrário, Contains devolve False. O caso é ignorado ao corresponder valores de chave.
Um Visual Basic Collection pode conter alguns elementos que têm chaves e outros elementos sem chaves. Isto depende se a chamada ao Add método fornece um argumento ao parâmetro opcional Key .