Metodo Contains (oggetto Collection)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce un valore Boolean che indica se un oggetto Collection Visual Basic contiene un elemento con una chiave specifica.

Public Function Contains( _
    ByVal Key As String _
) As Boolean

Parametri

Key
Obbligatorio. Espressione String che specifica la chiave da cercare negli elementi dell'insieme.

Eccezioni/Codici di errore

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	Il parametro Key specificato è Nothing.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Il metodo Contains restituisce True se nell'insieme è presente un elemento con una chiave che corrisponde esattamente a Key. In caso contrario, Contains restituisce False.

Un oggetto Collection Visual Basic può contenere alcuni elementi con chiavi e altri elementi senza chiavi, a seconda che la chiamata al Metodo Add (oggetto Collection) fornisca o meno un argomento al parametro Key facoltativo.

Esempio

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 si intende eseguire una ricerca nell'insieme per individuare elementi utilizzando le relative chiavi, è necessario fornire l'argomento Key a ogni chiamata del metodo Add.