C#のKeyValuePairとは？キーと値のペアをListで管理する方法をわかりやすく解説

KeyValuePairクラスとは

C#のKeyValuePair<TKey, TValue>は、1つの「キー（Key）」と「値（Value）」をペアとして格納するための汎用データ構造です。Dictionary<TKey, TValue>の内部でも利用されており、関連性のある2つの値をまとめて管理したい場面でとても便利です。

本記事では、Listと組み合わせて、複数のキーと値のペアを1つのリストに格納する方法を紹介します。

KeyValuePairを作成して要素を追加する

まずは、KeyValuePair型の要素を持つListを作成し、要素を追加する基本のコードを見てみましょう。

var myList = new List<KeyValuePair<string, int>>();

// 要素の追加
myList.Add(new KeyValuePair<string, int>("Laptop", 20));
myList.Add(new KeyValuePair<string, int>("Desktop", 40));
myList.Add(new KeyValuePair<string, int>("Tablet", 60));

このコードでは、string型のキーとint型の値を組み合わせたKeyValuePairを3つ作成し、Listに追加しています。たとえば「Laptop」というキーには数量「20」が対応付けられています。

サンプルプログラム：キーと値の一覧を表示する

続いて、KeyValuePairを実際に動かし、登録したキーと値をコンソールに出力する完全なサンプルコードを確認しましょう。

完全なコード例

using System;
using System.Collections.Generic;

class Program {
    static void Main() {
        var myList = new List<KeyValuePair<string, int>>();

        // 要素の追加
        myList.Add(new KeyValuePair<string, int>("Laptop", 20));
        myList.Add(new KeyValuePair<string, int>("Desktop", 40));
        myList.Add(new KeyValuePair<string, int>("Tablet", 60));

        foreach (var val in myList) {
            Console.WriteLine(val);
        }
    }
}

実行結果

[Laptop, 20]
[Desktop, 40]
[Tablet, 60]

foreachループで各要素を順番に取り出し、Console.WriteLineメソッドで出力すると、上記のように「[キー, 値]」の形式で表示されます。

Key・Valueプロパティで個別にアクセスする

foreachループ内では、KeyプロパティとValueプロパティを使って、キーと値をそれぞれ独立して取得することも可能です。文字列補間と組み合わせると、より見やすい出力が実現できます。

foreach (var val in myList) {
    Console.WriteLine($"商品名: {val.Key}, 数量: {val.Value}");
}

まとめ

• KeyValuePair<TKey, TValue>は、キーと値のペアを1つのオブジェクトとして扱える便利な構造体。
• List<KeyValuePair<TKey, TValue>>と組み合わせれば、複数のペアを順序付きで管理できる。
• Key・Valueプロパティを使えば、キーと値を個別に取り出すことも可能。

辞書のように高速な検索が必要なければ、KeyValuePairのListはシンプルで扱いやすい選択肢となります。ぜひ実際の開発で活用してみてください。