C#のDictionary.Add()メソッドの使い方を徹底解説！キーと値の追加方法

C#におけるDictionary.Add()メソッドは、ディクショナリ（Dictionary<TKey, TValue>）に指定したキーと値のペアを追加するために使用されるメソッドです。この記事では、Add()メソッドの基本的な構文から、実際のコード例、実行結果までをわかりやすく解説します。

Dictionary.Add()メソッドの構文

Add()メソッドの構文は以下の通りです。

public void Add (TKey key, TValue val);

各パラメータの意味は次のようになっています。

• key：追加する要素のキー
• val：追加する要素の値

注意点：重複したキーは追加できない

Dictionaryでは各キーが一意である必要があるため、すでに存在するキーをAdd()メソッドで追加しようとすると、System.ArgumentExceptionがスローされます。既存のキーの値を更新したい場合は、Add()ではなくインデクサ（dict[key] = value）を使用しましょう。

例1：基本的な使い方

まずは、Dictionary.Add()メソッドを使って複数のキーと値を追加する基本的な例を見てみましょう。

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("Key/value pairs...");
        foreach(KeyValuePair<string, string> res in dict){
            Console.WriteLine("Key = {0}, Value = {1}", res.Key, res.Value);
        }
    }
}

出力結果

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

Key/value pairs...
Key = One, Value = John
Key = Two, Value = Tom
Key = Three, Value = Jacob
Key = Four, Value = Kevin
Key = Five, Value = Nathan

foreachループを使ってKeyValuePair<string, string>として各要素を取り出し、キーと値を順番に表示しています。

例2：Countプロパティで要素数を確認しながら追加する

次に、Add()メソッドで要素を追加する前後で、Countプロパティを使ってディクショナリ内の要素数がどのように変化するかを確認してみましょう。

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("Count of elements = "+dict.Count);
        dict.Add("Six", "Anne");
        dict.Add("Seven", "Katie");
        Console.WriteLine("Count of elements (updated) = "+dict.Count);
        Console.WriteLine("Key/value pairs...");
        foreach(KeyValuePair<string, string> res in dict){
            Console.WriteLine("Key = {0}, Value = {1}", res.Key, res.Value);
        }
    }
}

出力結果

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

Count of elements = 5
Count of elements (updated) = 7
Key/value pairs...
Key = One, Value = John
Key = Two, Value = Tom
Key = Three, Value = Jacob
Key = Four, Value = Kevin
Key = Five, Value = Nathan
Key = Six, Value = Anne
Key = Seven, Value = Katie

最初に5つの要素を追加した時点ではCountは「5」ですが、さらに「Six」と「Seven」の2つを追加した後には「7」に更新されていることが確認できます。

まとめ

Dictionary.Add()メソッドは、C#のディクショナリに新しいキーと値のペアを追加するための基本かつ重要なメソッドです。ただし、同じキーを重複して追加すると例外が発生する点には注意が必要です。キーの存在チェックにはContainsKey()メソッドやTryGetValue()メソッドを組み合わせると、より安全なコードを書くことができます。