C#でのHashtableとDictionaryの使い方徹底解説：基本操作からサンプルコードまで

C#では、キーと値のペアを扱うコレクションとして「Hashtable」と「Dictionary」がよく使われます。どちらもキーを基準に要素へ高速にアクセスできる便利なクラスですが、それぞれ特徴や使い方が異なります。この記事では、両者の主なメソッドと実際のコード例を通じて、基本的な操作方法をわかりやすく解説します。

Hashtable（ハッシュテーブル）とは

Hashtable クラスは、キーのハッシュコードに基づいて整理された、キーと値のペアのコレクションを表します。格納された要素には、キーを使ってアクセスします。非ジェネリック型のため、キー・値ともに object 型として扱われる点が特徴です。

Hashtableの主なメソッド

Hashtableの使用例

次の例では、部署コードをキーとして部署名をHashtableに登録し、重複チェックを行ったうえで全要素を表示しています。

using System;
using System.Collections;

namespace Demo {
    class Program {
        static void Main(string[] args) {
            Hashtable ht = new Hashtable();

            ht.Add("D01", "Finance");
            ht.Add("D02", "HR");
            ht.Add("D03", "Operations");

            if (ht.ContainsValue("Marketing")) {
                Console.WriteLine("This department name is already in the list");
            } else {
                ht.Add("D04", "Marketing");
            }

            ICollection key = ht.Keys;

            foreach (string k in key) {
                Console.WriteLine(k + ": " + ht[k]);
            }
            Console.ReadKey();
        }
    }
}

実行結果

D04: Marketing
D02: HR
D03: Operations
D01: Finance

この例では、まず Add() メソッドで3つの部署を登録し、ContainsValue() で「Marketing」という値が既に存在するかを確認しています。存在しないため、新たに「D04: Marketing」が追加されます。最後に Keys プロパティで全キーを取得し、foreachループで各キーと対応する値を出力しています。

Dictionary（ディクショナリ）とは

Dictionary<TKey, TValue> は、C#におけるジェネリック版のキーと値のコレクションです。System.Collections.Generic 名前空間に含まれており、キーと値の型を明確に指定できるため、型安全性が高く、ボックス化・ボックス化解除のオーバーヘッドもありません。現在のC#開発では、非ジェネリックなHashtableよりもDictionaryを使用するのが一般的です。

Dictionaryの主なメソッド・プロパティ

Dictionaryの使用例

次の例では、int型のキーと値を持つDictionaryに5つの要素を追加し、Count プロパティで要素数を表示しています。

using System;
using System.Collections.Generic;

public class Demo {
    public static void Main() {

        IDictionary<int, int> d = new Dictionary<int, int>();
        d.Add(1, 44);
        d.Add(2, 34);
        d.Add(3, 66);
        d.Add(4, 47);
        d.Add(5, 76);

        Console.WriteLine(d.Count);
    }
}

実行結果

5

まとめ

HashtableとDictionaryはどちらもキーと値のペアを管理するコレクションですが、Dictionaryはジェネリック対応で型安全・高性能であるため、新規開発ではDictionaryの使用が推奨されます。一方、レガシーコードの保守などではHashtableに出会うこともあります。それぞれのメソッドの使い方を理解しておくと、状況に応じた適切なコレクション選択ができるようになります。