Collection.Contains 方法

注意：這個方法是 .NET Framework 2.0 版的新功能。

傳回 Boolean 值，指出 Visual Basic Collection 物件是否包含具有特定索引鍵的項目。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Function Contains ( _
    Key As String _
) As Boolean
'用途
Dim instance As Collection
Dim Key As String
Dim returnValue As Boolean

returnValue = instance.Contains(Key)

public bool Contains (
    string Key
)

public:
bool Contains (
    String^ Key
)

public boolean Contains (
    String Key
)

public function Contains (
    Key : String
) : boolean

參數

• Key
  必要項。String 運算式，可指定要搜尋集合項目的索引鍵。

傳回值

傳回 Boolean 值，指出 Visual Basic Collection 物件是否包含具有特定索引鍵的項目。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 Contains 方法 (Collection 物件)。

如果集合所包含的項目具有與 Key 完全相符的索引鍵，則 Contains 會傳回 True。否則，Contains 會傳回 False。

Visual Basic Collection 可以保存一些有索引鍵的項目，以及其他不具索引鍵的項目。這將取決於 Add 方法 (集合物件) 的呼叫是否提供選擇性 Key 參數的引數而定。

範例

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

如果您打算要搜尋集合中的項目 (利用這些項目的索引鍵)，請務必在每次呼叫 Add 方法時都提供 Key 引數。

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0

.NET Compact Framework

支援版本：2.0

請參閱

參考

Collection 類別
Collection 成員
Microsoft.VisualBasic 命名空間

其他資源

Contains 方法 (Collection 物件)
Collection 物件 (Visual Basic)
Item 屬性 (Collection 物件)
Count 屬性 (Collection 物件)
Add 方法 (集合物件)
Remove 方法 (Collection 物件)
Clear 方法 (Collection 物件)