この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

Dictionary<TKey, TValue>.ContainsKey メソッド (TKey)

 

公開日: 2016年10月

指定したキーが Dictionary<TKey, TValue> に格納されているかどうかを判断します。

名前空間:   System.Collections.Generic
アセンブリ:  mscorlib (mscorlib.dll 内)

public bool ContainsKey(
	TKey key
)

パラメーター

key
Type: TKey

Dictionary<TKey, TValue> 内で検索されるキー。

戻り値

Type: System.Boolean

指定したキーを持つ要素が true に格納されている場合は Dictionary<TKey, TValue>。それ以外の場合は false

Exception Condition
ArgumentNullException

keynull です。

This method approaches an O(1) operation.

The following code example shows how to use the M:System.Collections.Generic.Dictionary`2.ContainsKey(`0) method to test whether a key exists prior to calling the M:System.Collections.Generic.Dictionary`2.Add(`0,`1) method. It also shows how to use the M:System.Collections.Generic.Dictionary`2.TryGetValue(`0,`1@) method to retrieve values, which is an efficient way to retrieve values when a program frequently tries keys that are not in the dictionary. Finally, it shows the least efficient way to test whether keys exist, by using the P:System.Collections.Generic.Dictionary`2.Item(`0) property (the indexer in C#).

This code example is part of a larger example provided for the T:System.Collections.Generic.Dictionary`2 class (openWith is the name of the Dictionary used in this example).

// ContainsKey can be used to test keys before inserting 
// them.
if (!openWith.ContainsKey("ht"))
{
    openWith.Add("ht", "hypertrm.exe");
    Console.WriteLine("Value added for key = \"ht\": {0}", 
        openWith["ht"]);
}
// When a program often has to try keys that turn out not to
// be in the dictionary, TryGetValue can be a more efficient 
// way to retrieve values.
string value = "";
if (openWith.TryGetValue("tif", out value))
{
    Console.WriteLine("For key = \"tif\", value = {0}.", value);
}
else
{
    Console.WriteLine("Key = \"tif\" is not found.");
}
// The indexer throws an exception if the requested key is
// not in the dictionary.
try
{
    Console.WriteLine("For key = \"tif\", value = {0}.", 
        openWith["tif"]);
}
catch (KeyNotFoundException)
{
    Console.WriteLine("Key = \"tif\" is not found.");
}

ユニバーサル Windows プラットフォーム
8 以降で使用可能
.NET Framework
2.0 以降で使用可能
ポータブル クラス ライブラリ
サポート対象: 移植可能 .NET プラットフォーム
Silverlight
2.0 以降で使用可能
Windows Phone Silverlight
7.0 以降で使用可能
Windows Phone
8.1 以降で使用可能
トップに戻る
表示: