【C#】Dictionaryの使い方と基本操作：初期化・ループ・検索から高速化のコツまで解説

2026年2月28日2026年5月5日

配列・コレクション

C#を用いたアプリケーション開発において、データの管理と検索を効率化するために欠かせないのがDictionary型です。

キーと値をペアにして保持するこのコレクションは、膨大なデータの中から目的の情報を一瞬で取り出すことができる優れた性能を持っています。

本記事では、Dictionaryの基本的な使い方から、実務で役立つ応用テクニック、さらにはパフォーマンスを最大限に引き出すための高速化のコツまで、テクニカルライターの視点で詳しく解説します。

目次 [ close ]

Dictionaryの基本概念と特徴

Dictionaryは、C#の「System.Collections.Generic」名前空間に用意されているジェネリックコレクションの一つです。

一般的に「連想配列」や「マップ」とも呼ばれ、特定の「キー (Key)」に対して「値 (Value)」を紐付けて保存する仕組みを持っています。

Dictionaryの最大の特徴は、ハッシュテーブルというアルゴリズムを利用している点にあります。

これにより、データ量が増えても特定のキーに対応する値を検索する速度がほとんど低下せず、計算量は平均して O(1) となります。

これは、配列やListのように先頭から順番に要素を探す O(n) の探索と比較して、極めて高い効率を誇ります。

ただし、Dictionaryを使用する際にはいくつかの制約も存在します。

まず、同一のキーを重複して登録することはできません。

また、キーとして使用するオブジェクトには、一意性を識別するための適切なハッシュコード生成と等価比較の仕組みが必要です。

これらの特性を理解した上で、適切な場面でDictionaryを選択することが、洗練されたプログラムを書くための第一歩となります。

Dictionaryの宣言と初期化

C#では、Dictionaryを初期化する方法がいくつか用意されています。

プロジェクトのC#バージョンや、読みやすさの好みに応じて使い分けることができます。

基本的な初期化とコレクション初期化子

最も一般的な方法は、クラスをインスタンス化する際にコレクション初期化子を使用する方法です。

波括弧を用いた直感的な記法で、初期データを定義できます。

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        // 基本的な初期化（int型のキーとstring型の値）
        var users = new Dictionary<int, string>
        {
            { 1, "田中 太郎" },
            { 2, "佐藤 花子" },
            { 3, "鈴木 一郎" }
        };

        // 結果の出力
        Console.WriteLine($"ユーザー数: {users.Count}");
    }
}

実行結果

ユーザー数: 3

C# 12以降のコレクション式

最新のC# 12以降では、コレクション式を利用して、より簡潔に記述することが可能になりました。

角括弧 [] を使用するこの記法は、配列やListと同様の感覚でDictionaryを扱えるため、コードの可読性が大幅に向上します。

// C# 12以降のコレクション式による初期化
Dictionary<string, string> config = [
    ["Theme", "Dark"],
    ["Language", "Japanese"],
    ["FontSize", "14"]
];

foreach (var item in config)
{
    Console.WriteLine($"{item.Key}: {item.Value}");
}

実行結果

Theme: Dark
Language: Japanese
FontSize: 14

データの追加・更新・削除

Dictionaryに対する基本的な操作である「追加」「更新」「削除」の方法について解説します。

特に、既存のキーが存在する場合の挙動には注意が必要です。

要素の追加とインデクサによる更新

要素を追加するには Add メソッドを使用しますが、既に存在するキーに対して Add を呼び出すと ArgumentException が発生します。

一方で、インデクサ [] を使用した場合は、キーが存在しなければ追加、存在すれば上書きという挙動になります。

var inventory = new Dictionary<string, int>();

// Addメソッドによる追加
inventory.Add("Apple", 10);

// インデクサによる追加または更新
inventory["Banana"] = 20; // 追加
inventory["Apple"] = 15;  // 上書き（更新）

Console.WriteLine($"Appleの在庫: {inventory["Apple"]}");

実行結果

Appleの在庫: 15

安全に要素を追加したい場合は、TryAdd メソッドが便利です。

このメソッドは、キーが既に存在する場合は false を返し、例外を発生させずに処理を続行できます。

要素の削除とクリア

特定の要素を削除するには Remove メソッドを、すべての要素を削除するには Clear メソッドを使用します。

var data = new Dictionary<int, string> { { 1, "A" }, { 2, "B" } };

// 特定のキーを削除
bool isRemoved = data.Remove(1);

// すべてを削除
data.Clear();

データの検索と安全な値の取得

Dictionaryから値を検索する際、最も避けなければならないのは、存在しないキーに対してインデクサでアクセスし KeyNotFoundException を発生させることです。

これを防ぐための安全な検索方法を紹介します。

TryGetValueによる安全な取得

実務で最も推奨されるのが TryGetValueメソッドです。

このメソッドは、キーの存在確認と値の取得を同時に行います。

var prices = new Dictionary<string, int> { { "Coffee", 450 }, { "Tea", 400 } };

if (prices.TryGetValue("Coffee", out int price))
{
    Console.WriteLine($"価格は {price} 円です。");
}
else
{
    Console.WriteLine("商品が見つかりません。");
}

実行結果

価格は 450 円です。

ContainsKeyによる存在確認

値自体は必要なく、キーが存在するかどうかだけを確認したい場合は ContainsKey メソッドを使用します。

if (prices.ContainsKey("GreenTea"))
{
    // 処理
}

Dictionaryのループ処理（反復処理）

Dictionary内に格納されたすべてのペアに対して処理を行いたい場合、foreach 文を使用するのが一般的です。

KeyValuePairによるループ

基本的には KeyValuePair<TKey, TValue> 型として要素を取り出します。

var scores = new Dictionary<string, int> { { "Alice", 90 }, { "Bob", 85 } };

foreach (KeyValuePair<string, int> entry in scores)
{
    Console.WriteLine($"{entry.Key}さんのスコア: {entry.Value}");
}

分解（Deconstruction）を利用したループ

C# 7.0以降では、分解を利用して、より簡潔にキーと値を直接変数に代入してループを回すことができます。

foreach (var (name, score) in scores)
{
    Console.WriteLine($"{name}: {score}");
}

この書き方はコードが非常にスッキリするため、現代的なC#開発では主流となっています。

LINQとの連携

DictionaryはLINQ（Language Integrated Query）と非常に相性が良く、複雑なフィルタリングや変換を簡潔に記述できます。

Dictionaryのフィルタリング

特定の条件に合致する要素だけを抽出して、新しいDictionaryを作成する例です。

using System.Linq;

var original = new Dictionary<string, int>
{
    { "ProductA", 100 },
    { "ProductB", 250 },
    { "ProductC", 50 }
};

// 100より大きい値を持つ要素のみを抽出
var filtered = original
    .Where(kvp => kvp.Value > 100)
    .ToDictionary(kvp => kvp.Key, kvp => kvp.Value);

foreach (var item in filtered)
{
    Console.WriteLine($"{item.Key}: {item.Value}");
}

実行結果

ProductB: 250

ListからDictionaryへの変換

ToDictionary メソッドを使用すると、オブジェクトのリストを特定のプロパティをキーにしたDictionaryへ変換できます。

これはマスターデータのキャッシュ作成などで頻出するパターンです。

高度な使い方：独自の型をキーにする

Dictionaryのキーに、自作のクラスや構造体を使用したい場合があります。

この時、正しく動作させるためにはEqualsメソッドとGetHashCodeメソッドのオーバーライド、あるいは IEqualityComparer<T> の実装が必要です。

等価比較の重要性

Dictionaryは内部でハッシュコードを使用してバケットを管理しています。

デフォルトの参照比較では、プロパティの内容が同じであっても、インスタンスが異なれば「別のキー」とみなされてしまいます。

要素	役割
GetHashCode	オブジェクトを数値（ハッシュ値）に変換し、検索の高速化を補助する
Equals	ハッシュ値が衝突した場合に、実際に値が同じかどうかを厳密に比較する

public class UserKey
{
    public int Id { get; set; }
    public string Code { get; set; }

    public override bool Equals(object obj)
    {
        if (obj is UserKey other)
        {
            return Id == other.Id && Code == other.Code;
        }
        return false;
    }

    public override int GetHashCode()
    {
        return HashCode.Combine(Id, Code);
    }
}

このように実装することで、独自のオブジェクトをキーとして安全に利用できるようになります。

パフォーマンスと高速化のコツ

大規模なデータを扱う場合、Dictionaryのパフォーマンスを最適化することがシステム全体の速度に直結します。

1. 初期のキャパシティ指定

Dictionaryは要素が増えるたびに内部配列を自動で拡張（リサイズ）しますが、これには大きなコストがかかります。

あらかじめデータ件数が予測できる場合は、コンストラクタで初期キャパシティ（容量）を指定しましょう。

// 10,000件の要素が入ることがわかっている場合
var largeData = new Dictionary<int, string>(10000);

これにより、リサイズによるメモリ再確保とハッシュ再計算の発生を抑えることができ、実行速度を大幅に向上させることが可能です。

2. 文字列キーの比較オプション

文字列をキーにする際、大文字小文字を区別せずに検索したい場合があります。

その際、取得後に ToLower() を呼び出すのではなく、Dictionary作成時に StringComparer を指定するのが正解です。

var settings = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
settings["Key"] = "Value";

// "key" でもアクセス可能になる
Console.WriteLine(settings["key"]);

これはパフォーマンスが良いだけでなく、ロケールに依存しない安全な比較を行うためにも推奨されます。