Collection.Contains(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, показывающее, содержит ли объект Visual Basic Collection
элемент с указанным ключом.
public:
bool Contains(System::String ^ Key);
public bool Contains (string Key);
member this.Contains : string -> bool
Public Function Contains (Key As String) As Boolean
Параметры
- Key
- String
Обязательный. Выражение типа String
, которое задает ключ для поиска элемента в коллекции.
Возвращаемое значение
Значение true
, если объект Visual Basic Collection
содержит элемент с указанным ключом; в противном случае — false
.
Примеры
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
Если вы планируете искать элементы в коллекции, используя их ключи, не забудьте указывать Key
аргумент при каждом вызове Add
метода .
Комментарии
Contains
возвращает значение True
, если коллекция содержит элемент с ключом, точно соответствующим Key
. В противном случае Contains
возвращает значение False
. Регистр игнорируется при сопоставлении значений ключа.
Visual Basic Collection
может содержать некоторые элементы, имеющие ключи, и другие элементы без ключей. Это зависит от того, предоставляет ли вызов Add метода аргумент необязательному Key
параметру.