C#のContainsKey()メソッドとは？Hashtableでキーの存在を確認する方法

C#のContainsKey()メソッドは、Hashtableコレクション内に指定したキーが存在するかどうかを確認するための便利なメソッドです。キーが存在する場合はTrue、存在しない場合はFalseを返します。

ContainsKey()メソッドの基本的な使い方

まず、Hashtableコレクションを作成し、いくつかの要素を追加してみましょう。

Hashtable h = new Hashtable();
h.Add(1, "Sam");
h.Add(2, "Jack");
h.Add(3, "Andy");
h.Add(4, "Katie");
h.Add(5, "Beth");
h.Add(6, "Benjamin");

次に、ContainsKey()メソッドを使って、特定のキーがHashtable内に存在するかどうかを確認します。ここでは例として、キー「3」の存在をチェックしてみます。キーが見つかった場合、戻り値としてTrueが返されます。

h.ContainsKey(3);

サンプルコード

以下は、ContainsKey()メソッドの実際の使用例です。Hashtableに格納されたすべてのキーと値を表示した後、キー「3」が存在するかどうかを確認しています。

using System;
using System.Collections;
public class Demo {
    public static void Main() {
        Hashtable h = new Hashtable();
        h.Add(1, "Sam");
        h.Add(2, "Jack");
        h.Add(3, "Andy");
        h.Add(4, "Katie");
        h.Add(5, "Beth");
        h.Add(6, "Benjamin");
        Console.WriteLine("Keys and Values list:");
        foreach (var key in h.Keys ) {
            Console.WriteLine("Key = {0}, Value = {1}",key , h[key]);
        }
        Console.WriteLine("Does the specified key exist? "+h.ContainsKey(3));
    }
}

実行結果

Keys and Values list:
Key = 6, Value = Benjamin
Key = 5, Value = Beth
Key = 4, Value = Katie
Key = 3, Value = Andy
Key = 2, Value = Jack
Key = 1, Value = Sam
Does the specified key exist? True

ポイントまとめ

• ContainsKey()メソッドは、Hashtable内のキーの有無を高速に判定できる（計算量はほぼO(1)）。
• 戻り値はbool型で、キーが存在すればtrue、存在しなければfalseとなる。
• 値ではなくキーを検索対象とするため、値の存在確認には別途ContainsValue()メソッドを使用する。

このように、ContainsKey()メソッドを活用することで、キーの重複登録を防いだり、安全にデータへアクセスしたりすることが可能になります。Hashtableを扱う際にはぜひ活用してみてください。