C#のOrderedDictionaryに含まれるキーと値のペアの数を取得する方法

OrderedDictionaryは、System.Collections.Specialized名前空間に属するコレクションクラスで、要素を追加した順序を保持したままキーと値のペアを管理できるのが特徴です。

OrderedDictionaryに格納されているキーと値のペアの数を取得するには、Countプロパティを使用します。このプロパティは、現在コレクション内に存在する要素の総数をint型の整数として返します。

基本的な使い方

以下の例では、6つのキーと値のペアを持つOrderedDictionaryを作成し、Countプロパティで要素数を確認します。その後、Clear()メソッドですべての要素を削除し、要素数がどのように変化するかを見てみましょう。

サンプルコード

using System;
using System.Collections;
using System.Collections.Specialized;

public class Demo {
   public static void Main() {
      OrderedDictionary dict = new OrderedDictionary();
      dict.Add("A", "Home Appliances");
      dict.Add("B", "Electronics");
      dict.Add("C", "Smart Wearables");
      dict.Add("D", "Pet Supplies");
      dict.Add("E", "Clothing");
      dict.Add("F", "Footwear");

      Console.WriteLine("OrderedDictionaryの要素一覧...");
      foreach(DictionaryEntry d in dict) {
         Console.WriteLine(d.Key + " " + d.Value);
      }

      Console.WriteLine("OrderedDictionaryの要素数 = " + dict.Count);

      // すべての要素を削除
      dict.Clear();
      Console.WriteLine("削除後のOrderedDictionaryの要素数 = " + dict.Count);
   }
}

実行結果

OrderedDictionaryの要素一覧...
A Home Appliances
B Electronics
C Smart Wearables
D Pet Supplies
E Clothing
F Footwear
OrderedDictionaryの要素数 = 6
削除後のOrderedDictionaryの要素数 = 0

コードのポイント

• Countプロパティ： コレクション内のキーと値のペアの総数を返します。要素を追加・削除すると、自動的に値が更新されます。
• Clear()メソッド： OrderedDictionaryからすべての要素を削除します。呼び出し後はCountが0になります。
• foreachループ： DictionaryEntry構造体を介して、各要素のKeyとValueにアクセスできます。要素は追加された順序で列挙されます。

応用例：2つのOrderedDictionaryの比較

次に、複数のOrderedDictionaryを扱う例を見てみましょう。この例では、要素数の取得に加えて、Equals()メソッドによる等価性の比較や、AsReadOnly()メソッドを使った読み取り専用コレクションの作成も確認します。

サンプルコード

using System;
using System.Collections;
using System.Collections.Specialized;

public class Demo {
   public static void Main() {
      OrderedDictionary dict1 = new OrderedDictionary();
      dict1.Add("A", "John");
      dict1.Add("B", "Andy");
      dict1.Add("C", "Jacob");
      dict1.Add("D", "Kevin");
      dict1.Add("E", "Gary");
      dict1.Add("F", "Nathan");
      dict1.Add("G", "Kevin");
      dict1.Add("H", "Ryan");

      Console.WriteLine("OrderedDictionary1の要素一覧...");
      foreach(DictionaryEntry d in dict1) {
         Console.WriteLine(d.Key + " " + d.Value);
      }
      Console.WriteLine("OrderedDictionary1のキーと値のペア数 = " + dict1.Count);

      OrderedDictionary dict2 = new OrderedDictionary();
      dict2.Add("1", "One");
      dict2.Add("2", "Two");
      dict2.Add("3", "Three");
      dict2.Add("4", "Four");
      dict2.Add("5", "Five");
      dict2.Add("6", "Six");

      Console.WriteLine("\nOrderedDictionary2の要素一覧...");
      foreach(DictionaryEntry d in dict2) {
         Console.WriteLine(d.Key + " " + d.Value);
      }
      Console.WriteLine("OrderedDictionary2のキーと値のペア数 = " + dict2.Count);

      Console.WriteLine("\nOrderedDictionary1とOrderedDictionary2は等しいか？ = " + (dict1.Equals(dict2)));

      OrderedDictionary orderedDict = dict2.AsReadOnly();
      Console.WriteLine("OrderedDictionaryは読み取り専用か？ = " + orderedDict.IsReadOnly);
   }
}

実行結果

OrderedDictionary1の要素一覧...
A John
B Andy
C Jacob
D Kevin
E Gary
F Nathan
G Kevin
H Ryan
OrderedDictionary1のキーと値のペア数 = 8

OrderedDictionary2の要素一覧...
1 One
2 Two
3 Three
4 Four
5 Five
6 Six
OrderedDictionary2のキーと値のペア数 = 6

OrderedDictionary1とOrderedDictionary2は等しいか？ = False
OrderedDictionaryは読み取り専用か？ = True

補足ポイント

• Equals()メソッド： 2つのOrderedDictionaryが等しいかどうかを判定します。内容が異なるため、この例ではFalseが返されます。
• AsReadOnly()メソッド： 元のコレクションを読み取り専用のラッパーとして返します。IsReadOnlyプロパティがTrueになるため、以降は要素の追加・削除ができなくなります。
• 重複キーの扱い： 同じキーをAddしようとするとArgumentExceptionが発生するため、事前にContains()メソッドでキーの存在を確認するのが安全です。

まとめ

OrderedDictionaryの要素数を取得するにはCountプロパティを使います。Clear()メソッドで全要素を削除すればCountは0になり、AsReadOnly()メソッドを使えば読み取り専用のコレクションを作成できます。要素の追加順序を保持したい場面では、通常のHashtableではなくOrderedDictionaryを選択することで、予測可能な順序でデータを扱えるようになります。