【C#】Dictionaryに指定したキーが存在するか確認する方法

C#の Dictionary<TKey, TValue> に特定のキーが存在するかどうかを確認するには、ContainsKey() メソッドを使用します。このメソッドは、指定したキーがディクショナリ内に存在すれば true を、存在しなければ false を返します。

ContainsKey() メソッドとは

ContainsKey() は、ディクショナリから指定されたキーを高速に検索するためのメソッドです。構文は以下のとおりです。

public bool ContainsKey(TKey key);

存在しないキーにアクセスすると例外が発生するため、値を取得する前にこのメソッドでキーの有無をチェックしておくと安全です。

サンプルコード1：キーが存在する場合

まずは、ディクショナリに存在するキー「Three」を検索する例を見てみましょう。

using System;
using System.Collections.Generic;

public class Demo {
   public static void Main() {
      Dictionary<string, string> dict = new Dictionary<string, string>();
      dict.Add("One", "John");
      dict.Add("Two", "Tom");
      dict.Add("Three", "Jacob");
      dict.Add("Four", "Kevin");
      dict.Add("Five", "Nathan");

      Console.WriteLine("要素数 = " + dict.Count);
      Console.WriteLine("\nキー/値のペア一覧...");
      foreach(KeyValuePair<string, string> res in dict) {
         Console.WriteLine("Key = {0}, Value = {1}", res.Key, res.Value);
      }

      if (dict.ContainsKey("Three"))
         Console.WriteLine("キーが見つかりました！");
      else
         Console.WriteLine("キーはディクショナリ内に存在しません！");

      dict.Clear();
      Console.WriteLine("クリア後のキー/値のペア一覧...");
      foreach(KeyValuePair<string, string> res in dict) {
         Console.WriteLine("Key = {0}, Value = {1}", res.Key, res.Value);
      }
      Console.WriteLine("現在の要素数 = " + dict.Count);
   }
}

実行結果

上記のコードを実行すると、次のような出力が得られます。

要素数 = 5
キー/値のペア一覧...
Key = One, Value = John
Key = Two, Value = Tom
Key = Three, Value = Jacob
Key = Four, Value = Kevin
Key = Five, Value = Nathan
キーが見つかりました！
クリア後のキー/値のペア一覧...
現在の要素数 = 0

この例では、キー「Three」がディクショナリに登録されているため、ContainsKey() は true を返し、「キーが見つかりました！」と表示されます。その後、Clear() メソッドですべての要素を削除しているため、最終的な要素数は 0 になっています。

サンプルコード2：キーが存在しない場合

次に、ディクショナリに存在しないキー「mykey」を検索した場合の動作を確認してみましょう。

using System;
using System.Collections.Generic;

public class Demo {
   public static void Main() {
      Dictionary<string, string> dict = new Dictionary<string, string>();
      dict.Add("One", "John");
      dict.Add("Two", "Tom");
      dict.Add("Three", "Jacob");
      dict.Add("Four", "Kevin");
      dict.Add("Five", "Nathan");

      Console.WriteLine("要素数 = " + dict.Count);
      Console.WriteLine("\nキー/値のペア一覧...");
      foreach(KeyValuePair<string, string> res in dict) {
         Console.WriteLine("Key = {0}, Value = {1}", res.Key, res.Value);
      }

      if (dict.ContainsKey("mykey"))
         Console.WriteLine("キーが見つかりました！");
      else
         Console.WriteLine("キーはディクショナリ内に存在しません！");

      dict.Clear();
      Console.WriteLine("クリア後のキー/値のペア一覧...");
      foreach(KeyValuePair<string, string> res in dict) {
         Console.WriteLine("Key = {0}, Value = {1}", res.Key, res.Value);
      }
      Console.WriteLine("現在の要素数 = " + dict.Count);
   }
}

実行結果

実行結果は以下のとおりです。

要素数 = 5
キー/値のペア一覧...
Key = One, Value = John
Key = Two, Value = Tom
Key = Three, Value = Jacob
Key = Four, Value = Kevin
Key = Five, Value = Nathan
キーはディクショナリ内に存在しません！
クリア後のキー/値のペア一覧...
現在の要素数 = 0

キー「mykey」は登録されていないため、ContainsKey() は false を返し、「キーはディクショナリ内に存在しません！」というメッセージが出力されます。

まとめ

• Dictionary<TKey, TValue> に指定したキーが存在するかどうかは、ContainsKey() メソッドで確認できる。
• キーが存在すれば true、存在しなければ false が返される。
• インデクサで直接値にアクセスする前に ContainsKey() でチェックすることで、KeyNotFoundException の発生を防げる。