C#のSortedDictionary.Item[]プロパティとは？使い方とサンプルコードを解説

C#のSortedDictionary.Item[]プロパティは、指定したキーに関連付けられた値を取得または設定するために使用されます。インデクサとして機能するため、配列のようにキーを指定して要素へアクセスできるのが特徴です。

構文

Item[]プロパティの構文は以下の通りです。

public TValue this[TKey k] { get; set; }

ここで、k は取得または設定対象となる値のキーを表します。getでは指定したキーに対応する値を読み取り、setではそのキーに新しい値を割り当てることができます。

使用例1：値の取得

まず、Item[]プロパティを使って特定のキーの値を取得する例を見てみましょう。

using System;
using System.Collections;
using System.Collections.Generic;

public class Demo {
   public static void Main(){
      SortedDictionary<int, string> sortedDict = new SortedDictionary<int, string>();
      sortedDict.Add(1, "One");
      sortedDict.Add(2, "Two");
      sortedDict.Add(3, "Three");
      sortedDict.Add(4, "Four");
      sortedDict.Add(5, "Five");
      sortedDict.Add(6, "Six");

      Console.WriteLine("SortedDictionary key-value pairs...");
      IDictionaryEnumerator demoEnum = sortedDict.GetEnumerator();
      while (demoEnum.MoveNext())
         Console.WriteLine("Key = " + demoEnum.Key + ", Value = " + demoEnum.Value);

      Console.WriteLine("Count of SortedDictionary key-value pairs = " + sortedDict.Count);

      sortedDict.Add(7, "Seven");
      sortedDict.Add(8, "Eight");

      Console.WriteLine("\nSortedDictionary key-value pairs...UPDATED");
      demoEnum = sortedDict.GetEnumerator();
      while (demoEnum.MoveNext())
         Console.WriteLine("Key = " + demoEnum.Key + ", Value = " + demoEnum.Value);

      Console.WriteLine("Count of SortedDictionary key-value pairs (UPDATED) = " + sortedDict.Count);

      // Item[]プロパティでキー5の値を取得
      Console.WriteLine("Value in the SortedDictionary key-value pair key five = " + sortedDict[5]);

      sortedDict.Clear();
      Console.WriteLine("\nCount of SortedDictionary key-value pairs (UPDATED) = " + sortedDict.Count);
   }
}

実行結果

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

Key = 1, Value = One
Key = 2, Value = Two
Key = 3, Value = Three
Key = 4, Value = Four
Key = 5, Value = Five
Key = 6, Value = Six
Count of SortedDictionary key-value pairs = 6
SortedDictionary key-value pairs...UPDATED
Key = 1, Value = One
Key = 2, Value = Two
Key = 3, Value = Three
Key = 4, Value = Four
Key = 5, Value = Five
Key = 6, Value = Six
Key = 7, Value = Seven
Key = 8, Value = Eight
Count of SortedDictionary key-value pairs (UPDATED) = 8
Value in the SortedDictionary key-value pair key five = Five
Count of SortedDictionary key-value pairs (UPDATED) = 0

この例では、sortedDict[5] のようにキーを指定することで、キー5に関連付けられた値「Five」を取得できていることが確認できます。

使用例2：値の設定（更新）

続いて、Item[]プロパティを使って既存のキーの値を更新する例を見てみましょう。

using System;
using System.Collections;
using System.Collections.Generic;

public class Demo {
   public static void Main(){
      SortedDictionary<int, string> sortedDict = new SortedDictionary<int, string>();
      sortedDict.Add(1, "SUV");
      sortedDict.Add(2, "MUV");
      sortedDict.Add(3, "Utility Vehicle");
      sortedDict.Add(4, "AUV");
      sortedDict.Add(5, "Hatchback");
      sortedDict.Add(6, "Convertible");

      Console.WriteLine("SortedDictionary key-value pairs...");
      IDictionaryEnumerator demoEnum = sortedDict.GetEnumerator();
      while (demoEnum.MoveNext())
         Console.WriteLine("Key = " + demoEnum.Key + ", Value = " + demoEnum.Value);

      Console.WriteLine("Count of SortedDictionary key-value pairs = " + sortedDict.Count);

      sortedDict.Add(7, "Seven");
      sortedDict.Add(8, "Eight");

      Console.WriteLine("\nSortedDictionary key-value pairs...UPDATED");
      demoEnum = sortedDict.GetEnumerator();
      while (demoEnum.MoveNext())
         Console.WriteLine("Key = " + demoEnum.Key + ", Value = " + demoEnum.Value);

      Console.WriteLine("Count of SortedDictionary key-value pairs (UPDATED) = " + sortedDict.Count);

      // Item[]プロパティでキー5の値を取得
      Console.WriteLine("Value in the SortedDictionary key-value pair key five = " + sortedDict[5]);

      // Item[]プロパティでキー5の値を更新
      sortedDict[5] = "Crossover";
      Console.WriteLine("Value in the SortedDictionary key-value pair key five (updated) = " + sortedDict[5]);

      sortedDict.Clear();
      Console.WriteLine("\nCount of SortedDictionary key-value pairs (UPDATED) = " + sortedDict.Count);
   }
}

実行結果

このコードを実行すると、以下の出力が得られます。

SortedDictionary key-value pairs...
Key = 1, Value = SUV
Key = 2, Value = MUV
Key = 3, Value = Utility Vehicle
Key = 4, Value = AUV
Key = 5, Value = Hatchback
Key = 6, Value = Convertible
Count of SortedDictionary key-value pairs = 6
SortedDictionary key-value pairs...UPDATED
Key = 1, Value = SUV
Key = 2, Value = MUV
Key = 3, Value = Utility Vehicle
Key = 4, Value = AUV
Key = 5, Value = Hatchback
Key = 6, Value = Convertible
Key = 7, Value = Seven
Key = 8, Value = Eight
Count of SortedDictionary key-value pairs (UPDATED) = 8
Value in the SortedDictionary key-value pair key five = Hatchback
Value in the SortedDictionary key-value pair key five (updated) = Crossover
Count of SortedDictionary key-value pairs (UPDATED) = 0

実行結果から、sortedDict[5] = "Crossover"; という代入によって、キー5の値が「Hatchback」から「Crossover」に更新されたことがわかります。

まとめ

SortedDictionary.Item[]プロパティを使うことで、キーを指定して値の取得・設定を直感的に行えます。なお、存在しないキーを取得しようとした場合は KeyNotFoundException がスローされるため、事前に ContainsKey() メソッドなどでキーの存在を確認しておくと安全です。また、存在しないキーに対してsetを行った場合は、新しい要素として自動的に追加される点も覚えておくと便利です。