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

定义

确定是否 IDictionary 包含带有指定键的元素。

C#
bool IDictionary.Contains (object key);

参数

key
Object

要在 IDictionary 中定位的键。

返回

如果 true 包含具有指定键的元素,则为 IDictionary;否则为 false

实现

例外

keynull

示例

下面的代码示例演示如何将 接口的 System.Collections.IDictionary 方法与 一IDictionary.Contains起使用Dictionary<TKey,TValue>。 该示例演示如果提供了错误数据类型的键,则方法将返回 false

代码示例是为 方法提供的更大示例(包括输出)的一 IDictionary.Add 部分。

C#
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");
C#
// 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));
C#
    }
}

注解

如果 key 的类型不可分配给 的键类型Dictionary<TKey,TValue>TKey,则此方法返回 false

此方法用于处理 O (1) 操作。

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0