C#のListDictionaryクラスとは？主なプロパティ・メソッドと使い方を解説

ListDictionaryクラスは、単方向リンクリスト（片方向連結リスト）を使用してIDictionaryインターフェースを実装したコレクションです。要素数が10個未満程度の小規模なコレクションを扱う場合に特に適しており、少ないデータ量であれば高速な動作が期待できます。

この記事では、ListDictionaryクラスの主なプロパティやメソッド、そして実際のコード例を通じてその基本的な使い方を詳しく解説します。

ListDictionaryクラスの主なプロパティ

ListDictionaryクラスには、以下のようなプロパティが用意されています。

ListDictionaryクラスの主なメソッド

次に、ListDictionaryクラスでよく使用されるメソッドを紹介します。

コード例：読み取り専用かどうかの確認

それでは、実際のコード例を見ていきましょう。まずは、ListDictionaryが読み取り専用かどうかを確認する例です。

using System;
using System.Collections;
using System.Collections.Specialized;
public class Demo {
   public static void Main() {
      ListDictionary dict1 = new ListDictionary();
      dict1.Add("A", "Books");
      dict1.Add("B", "Electronics");
      dict1.Add("C", "Smart Wearables");
      dict1.Add("D", "Pet Supplies");
      dict1.Add("E", "Clothing");
      dict1.Add("F", "Footwear");
      Console.WriteLine("ListDictionary1 elements...");
      foreach(DictionaryEntry d in dict1) {
         Console.WriteLine(d.Key + " " + d.Value);
      }
      Console.WriteLine("Is the ListDictionary1 having fixed size? = "+dict1.IsFixedSize);
      Console.WriteLine("If ListDictionary1 read-only? = "+dict1.IsReadOnly);
      Console.WriteLine("Is ListDictionary1 synchronized = "+dict1.IsSynchronized);
      Console.WriteLine("The ListDictionary1 has the key M? = "+dict1.Contains("M"));
      ListDictionary dict2 = new ListDictionary();
      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("
ListDictionary2 key-value pairs...");
      IDictionaryEnumerator demoEnum = dict2.GetEnumerator();
      while (demoEnum.MoveNext())
      Console.WriteLine("Key = " + demoEnum.Key + ", Value = "+ demoEnum.Value);
      Console.WriteLine("Is the ListDictionary2 having fixed size? = "+dict2.IsFixedSize);
      Console.WriteLine("If ListDictionary2 read-only? = "+dict2.IsReadOnly);
      Console.WriteLine("Is ListDictionary2 synchronized = "+dict2.IsSynchronized);
      Console.WriteLine("The ListDictionary2 has the key 5? = "+dict2.Contains("5"));
   }
}

出力結果

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

ListDictionary1 elements...
A Books
B Electronics
C Smart Wearables
D Pet Supplies
E Clothing
F Footwear
Is the ListDictionary1 having fixed size? = False
If ListDictionary1 read-only? = False
Is ListDictionary1 synchronized = False
The ListDictionary1 has the key M? = False
ListDictionary2 key-value pairs...
Key = 1, Value = One
Key = 2, Value = Two
Key = 3, Value = Three
Key = 4, Value = Four
Key = 5, Value = Five
Key = 6, Value = Six
Is the ListDictionary2 having fixed size? = False
If ListDictionary2 read-only? = False
Is ListDictionary2 synchronized = False
The ListDictionary2 has the key 5? = True

この出力から、ListDictionaryは既定では固定サイズでも読み取り専用でもなく、同期もされていないことがわかります。また、Contains()メソッドを使えば、特定のキーが存在するかどうかを簡単に確認できます。

コード例：2つのListDictionaryオブジェクトが等しいかどうかの確認

続いて、2つのListDictionaryオブジェクトが等しいかどうかを確認する例です。

Example

using System;
using System.Collections;
using System.Collections.Specialized;
public class Demo {
   public static void Main() {
      ListDictionary dict1 = new ListDictionary();
      dict1.Add("A", "Books");
      dict1.Add("B", "Electronics");
      dict1.Add("C", "Smart Wearables");
      dict1.Add("D", "Pet Supplies");
      dict1.Add("E", "Clothing");
      dict1.Add("F", "Footwear");
      Console.WriteLine("ListDictionary1 elements...");
      foreach(DictionaryEntry d in dict1) {
         Console.WriteLine(d.Key + " " + d.Value);
      }
      ListDictionary dict2 = new ListDictionary();
      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("
ListDictionary2 elements...");
      foreach(DictionaryEntry d in dict2) {
         Console.WriteLine(d.Key + " " + d.Value);
      }
      ListDictionary dict3 = new ListDictionary();
      dict3 = dict2;
      Console.WriteLine("
Is ListDictionary3 equal to ListDictionary2? = "+(dict3.Equals(dict2)));
   }
}

出力結果

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

ListDictionary1 elements...
A Books
B Electronics
C Smart Wearables
D Pet Supplies
E Clothing
F Footwear
ListDictionary2 elements...
1 One
2 Two
3 Three
4 Four
5 Five
6 Six
Is ListDictionary3 equal to ListDictionary2? = True

ここでは、dict3にdict2の参照を代入しているため、Equals()メソッドによる比較結果はTrueとなります。これは両者が同じオブジェクトを参照しているためです。

まとめ

ListDictionaryクラスは、単方向リンクリストベースの軽量なIDictionary実装であり、要素数が少ないコレクションの管理に最適です。プロパティやメソッドを活用することで、キーの存在確認や列挙処理なども柔軟に行えます。小規模なデータを扱う場面では、Hashtableなどの他のコレクションと比較して検討してみるとよいでしょう。