Dictionary<TKey,TValue>.IDictionary.Contains(Object) 方法

定義

命名空間:

System.Collections.Generic

組件:

System.Collections.dll

來源:

Dictionary.cs

判斷 IDictionary 是否包含具有指定之索引鍵的項目。

 virtual bool System.Collections.IDictionary.Contains(System::Object ^ key) = System::Collections::IDictionary::Contains;

bool IDictionary.Contains (object key);

abstract member System.Collections.IDictionary.Contains : obj -> bool
override this.System.Collections.IDictionary.Contains : obj -> bool

Function Contains (key As Object) As Boolean Implements IDictionary.Contains

參數

key

Object

要在 IDictionary 中尋找的索引鍵。

傳回

Boolean

如果 true 包含具有指定索引鍵的項目，則為 IDictionary，否則為 false。

實作

Contains(Object)

例外狀況

ArgumentNullException

key 為 null。

範例

下列程式代碼範例示範如何搭配 Dictionary<TKey,TValue>使用 IDictionary.Contains 介面的 System.Collections.IDictionary 方法。 這個範例示範如果提供錯誤資料類型的索引鍵，方法會傳回 false 。

程式代碼範例是較大範例的一部分，包括針對 IDictionary.Add 方法提供的輸出。

using System;
using System.Collections;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys,
        // and access it using the IDictionary interface.
        //
        IDictionary openWith = new Dictionary<string, string>();

        // Add some elements to the dictionary. There are no
        // duplicate keys, but some of the values are duplicates.
        // IDictionary.Add throws an exception if incorrect types
        // are supplied for key or value.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

Imports System.Collections
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new dictionary of strings, with string keys,
        ' and access it using the IDictionary interface.
        '
        Dim openWith As IDictionary = _
            New Dictionary(Of String, String)
        
        ' Add some elements to the dictionary. There are no 
        ' duplicate keys, but some of the values are duplicates.
        ' IDictionary.Add throws an exception if incorrect types
        ' are supplied for key or value.
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

// Contains can be used to test keys before inserting
// them.
if (!openWith.Contains("ht"))
{
    openWith.Add("ht", "hypertrm.exe");
    Console.WriteLine("Value added for key = \"ht\": {0}",
        openWith["ht"]);
}

// IDictionary.Contains returns false if the wrong data
// type is supplied.
Console.WriteLine("openWith.Contains(29.7) returns {0}",
    openWith.Contains(29.7));

' Contains can be used to test keys before inserting 
' them.
If Not openWith.Contains("ht") Then
    openWith.Add("ht", "hypertrm.exe")
    Console.WriteLine("Value added for key = ""ht"": {0}", _
        openWith("ht"))
End If

' IDictionary.Contains returns False if the wrong data 
' type is supplied.
Console.WriteLine("openWith.Contains(29.7) returns {0}", _
    openWith.Contains(29.7))

    }
}

    End Sub

End Class

備註

如果 key 無法指定給 之Dictionary<TKey,TValue>索引鍵類型的TKey型別，這個方法會false傳回 。

此方法會接近 O (1) 作業。