【C#】DictionaryのContainsKeyでキーの存在を確認する方法とTryGetValueとの使い分け解説

2026年3月1日2026年5月5日

配列・コレクション

C#を用いたアプリケーション開発において、データの検索効率を最大化するために Dictionary<TKey, TValue> クラスは欠かせない存在です。

キーと値のペアでデータを管理するこのコレクションは、特定の要素へ瞬時にアクセスできる強力な機能を備えています。

しかし、存在しないキーを指定して値を取得しようとすると KeyNotFoundException がスローされるため、安全にデータを操作するには「指定したキーが存在するかどうか」を事前に確認するプロセスが極めて重要となります。

本記事では、キーの存在確認における標準的な手法である ContainsKey メソッド の使い方から、より効率的な TryGetValue メソッド との使い分け、さらにはパフォーマンス面での内部動作や実務上の注意点まで、プロフェッショナルな視点で詳しく解説します。

目次 [ close ]

Dictionary.ContainsKey メソッドの基本

ContainsKey メソッドは、指定したキーが Dictionary 内に存在するかどうかを判定し、真偽値 (bool) で返すメソッドです。

このメソッドの最大の特徴は、その検索スピードの速さにあります。

メソッドのシグネチャと計算量

Dictionary<TKey, TValue>.ContainsKey の定義は以下のようになっています。

public bool ContainsKey (TKey key);

このメソッドの計算量は、平均して O(1) です。

これは、要素数が増えても検索にかかる時間がほぼ一定であることを意味します。

内部的にはキーのハッシュコードを利用して格納場所（バケット）を特定するため、リスト構造のように全要素を先頭から走査する必要がありません。

ContainsKey を使用した基本的なコード例

以下に、もっとも一般的な ContainsKey の使用例を示します。

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        // 辞書の初期化
        var userScores = new Dictionary<string, int>
        {
            { "Alice", 90 },
            { "Bob", 85 },
            { "Charlie", 95 }
        };

        string targetKey = "Alice";

        // キーの存在確認
        if (userScores.ContainsKey(targetKey))
        {
            // キーが存在する場合の処理
            int score = userScores[targetKey];
            Console.WriteLine($"{targetKey}さんのスコアは {score} です。");
        }
        else
        {
            // キーが存在しない場合の処理
            Console.WriteLine($"{targetKey}さんのデータは見つかりませんでした。");
        }
    }
}

実行結果

Aliceさんのスコアは 90 です。

このコードでは、インデクサ userScores[targetKey] にアクセスする前に必ず存在チェックを行っているため、実行時エラーを回避して安全に値を処理できています。

TryGetValue との比較と使い分け

実務において、ContainsKey と並んで頻繁に利用されるのが TryGetValue メソッドです。

これら二つのメソッドは役割が似ていますが、パフォーマンスの観点から明確な使い分けが推奨されます。

二重ルックアップ問題（Double Lookup）

先ほどの ContainsKey の例を振り返ってみましょう。

ContainsKey(targetKey) で内部的なハッシュ計算と検索を行う。
userScores[targetKey] で再び内部的なハッシュ計算と検索を行う。

このように、値を取得するために 2回の検索操作 が発生しています。

これを「二重ルックアップ」と呼びます。

要素数が非常に多い場合や、ループ内で大量に処理を行う場合、このオーバーヘッドが無視できなくなることがあります。

TryGetValue による最適化

TryGetValue を使用すると、「存在確認」と「値の取得」を 1回の検索操作で完結させることができます。

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var inventory = new Dictionary<string, int>
        {
            { "Apple", 50 },
            { "Banana", 30 }
        };

        string item = "Apple";

        // TryGetValueを使用して1回で取得する
        if (inventory.TryGetValue(item, out int count))
        {
            // 取得に成功した場合
            Console.WriteLine($"{item}の在庫は {count} 個です。");
        }
        else
        {
            // 取得に失敗した場合
            Console.WriteLine($"{item}は在庫リストにありません。");
        }
    }
}

実行結果

Appleの在庫は 50 個です。

どちらを使うべきかの基準

使い分けの指針は以下の通りです。

ContainsKey を使うべきケース値を取得する必要がなく、存在の有無だけを知りたい場合。 : キーが存在しない場合にのみ、特定のロジック（追加処理など）を実行したい場合。
TryGetValue を使うべきケースキーが存在する場合に、その値をそのまま利用する場合。 : パフォーマンスが求められるクリティカルなループ処理の中。

実践的な応用：キー比較のカスタマイズ

ContainsKey の挙動は、Dictionary 生成時に指定する比較子 (IEqualityComparer) によってカスタマイズ可能です。

特に文字列をキーにする場合、大文字小文字の区別が問題になることが多々あります。

大文字小文字を区別しない検索

デフォルトでは、"Key" と "key" は別のキーとして扱われます。

これを同一視したい場合は、コンストラクタで StringComparer を指定します。

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        // 大文字小文字を無視する設定でDictionaryを生成
        var settings = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase)
        {
            { "Theme", "Dark" },
            { "Language", "Japanese" }
        };

        // 小文字で検索してもヒットする
        if (settings.ContainsKey("theme"))
        {
            Console.WriteLine($"テーマ設定が見つかりました: {settings["theme"]}");
        }
    }
}

実行結果

テーマ設定が見つかりました: Dark

このように StringComparer.OrdinalIgnoreCase を利用することで、検索前に ToLower() を呼び出すなどの無駄な文字列生成を避けつつ、安全で直感的なキー検索が可能になります。

ContainsKey 使用時の注意点と例外

ContainsKey は非常に便利なメソッドですが、プログラミング上の落とし穴も存在します。

引数に null を渡した場合

Dictionary のキーとして null を使用することはできません。

そのため、ContainsKey の引数に null を渡すと、ArgumentNullException がスローされます。

Dictionary<string, int> dict = new Dictionary<string, int>();
// string key = null;
// bool exists = dict.ContainsKey(key); // ここで例外発生！

外部入力やメソッドの戻り値をそのままキーとして使用する場合は、事前に null チェックを行うか、条件演算子等でガードをかける必要があります。

マルチスレッド環境での動作

標準の Dictionary<TKey, TValue> はスレッドセーフではありません。

あるスレッドが ContainsKey でチェックしている最中に、別のスレッドが要素を削除したり追加したりすると、不整合が生じたり例外が発生したりする可能性があります。

マルチスレッド環境でキーの存在確認を安全に行うには、lock 文 による同期、あるいは System.Collections.Concurrent.ConcurrentDictionary の使用を検討してください。

ContainsValue メソッドとの違い

Dictionary にはキーではなく「値」を探す ContainsValue というメソッドも存在しますが、これとは性質が大きく異なります。

メソッド名	検索対象	計算量（平均）	特徴
ContainsKey	キー	O(1)	ハッシュ値を使って直接アクセスするため極めて高速
ContainsValue	値	O(n)	全要素をスキャンするため、要素数に比例して遅くなる

ContainsValue は、内部的にすべての値を列挙して比較を行うため、大規模なデータセットではパフォーマンスのボトルネックとなります。

「値からキーを逆引きしたい」という要件が頻発する場合は、逆引き用の Dictionary をもう一つ作成する などの設計変更が推奨されます。

C# 12/13 以降の最新動向とテクニック

C# は進化を続けており、コレクションの操作についてもより簡潔、あるいはより高度な制御が可能になっています。

コレクション式による初期化

C# 12 から導入されたコレクション式を用いることで、Dictionary の初期化がより簡潔に記述できるようになりました（ただし、現時点では Dictionary のターゲット型推論には一部制限があるため、従来の書き方や KeyValuePair の利用が一般的ですが、可読性は向上しています）。