【C#入門】Dictionaryに要素を追加する方法と基本操作

2024年8月30日

C#プログラミングにおいて、Dictionaryは非常に便利なデータ構造です。キーと値のペアでデータを管理できるため、多くの場面で活用されています。この記事では、C#でDictionaryに新しい要素を追加する方法と基本的な操作について、初心者の方にも分かりやすく解説します。

Dictionaryとは

Dictionaryは、キーと値のペアを格納するコレクションです。各キーは一意であり、それぞれの値に素早くアクセスできる特徴があります。

Dictionaryに要素を追加する方法

C#でDictionaryに要素を追加するには、主に以下の2つの方法があります：

Add メソッドを使用する方法
インデックス付け（角括弧）を使用する方法

それでは、具体的なコード例を見ながら、これらの方法を詳しく見ていきましょう。

using System;
using System.Collections.Generic;

class Program
{
    static void Main(string[] args)
    {
        // Dictionaryの作成
        Dictionary<string, int> scores = new Dictionary<string, int>();

        // 1. Add メソッドを使用して要素を追加
        scores.Add("Alice", 95);
        scores.Add("Bob", 80);

        // 2. インデックス付けを使用して要素を追加
        scores["Charlie"] = 88;

        // Dictionaryの内容を表示
        Console.WriteLine("スコア一覧:");
        foreach (var pair in scores)
        {
            Console.WriteLine($"{pair.Key}: {pair.Value}点");
        }

        // 既存のキーに対して値を更新
        scores["Bob"] = 85;
        Console.WriteLine("\nBobのスコアを更新後:");
        Console.WriteLine($"Bob: {scores["Bob"]}点");

        // キーが存在するかチェックしてから追加
        string newName = "David";
        if (!scores.ContainsKey(newName))
        {
            scores[newName] = 92;
            Console.WriteLine($"\n{newName}を追加しました。");
        }

        // 要素数の取得
        Console.WriteLine($"\n登録された学生数: {scores.Count}");

        // キーの存在確認
        string searchName = "Eve";
        if (scores.ContainsKey(searchName))
        {
            Console.WriteLine($"{searchName}のスコア: {scores[searchName]}点");
        }
        else
        {
            Console.WriteLine($"{searchName}は登録されていません。");
        }

        // 安全に値を取得
        if (scores.TryGetValue("Alice", out int aliceScore))
        {
            Console.WriteLine($"\nAliceのスコア: {aliceScore}点");
        }

        // 最終的なDictionaryの内容を表示
        Console.WriteLine("\n最終的なスコア一覧:");
        foreach (var pair in scores)
        {
            Console.WriteLine($"{pair.Key}: {pair.Value}点");
        }
    }
}

このコードでは、Dictionaryへの要素追加と基本操作について以下のポイントを示しています：

Add メソッドを使用した要素の追加
インデックス付け（角括弧）を使用した要素の追加と更新
foreach ループを使用したDictionaryの内容表示
ContainsKey メソッドを使用したキーの存在確認
Count プロパティを使用した要素数の取得
TryGetValue メソッドを使用した安全な値の取得

注意点

既に存在するキーに対してAdd メソッドを使用すると例外が発生します。
キーにnullは使用できません（ただし、値にはnullを使用できます）。
Dictionaryは順序を保持しません。要素の追加順序は保証されません。

まとめ

C#のDictionaryに要素を追加する方法と基本的な操作について解説しました。Dictionaryは効率的なデータ管理を可能にする強力なツールです。Add メソッドやインデックス付けを使用することで、簡単に要素を追加できます。また、ContainsKey や TryGetValue メソッドを活用することで、より安全にDictionaryを操作できます。

初心者の方々も、これらの基本を理解し実践することで、C#プログラミングのスキルを向上させることができます。実際にコードを書いて試すことで、Dictionaryの特性と使用方法をより深く理解できるでしょう。