KeyValuePair ジェネリック構造体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

KeyValuePair ジェネリック構造体

メモ : この構造体は、.NET Framework version 2.0 で新しく追加されたものです。

設定または取得できる、キー/値ペアを定義します。

名前空間: System.Collections.Generic
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Structure KeyValuePair(Of
 TKey, TValue)

Visual Basic (使用法)

Dim instance As KeyValuePair(Of
 TKey, TValue)

[SerializableAttribute] 
public struct KeyValuePair<TKey,TValue>

C++

[SerializableAttribute] 
generic<typename TKey, typename TValue>
public value class KeyValuePair

J# では、ジェネリックな型およびメソッドは使用できますが、新規に宣言することはできません。

JScript

JScript では、ジェネリックな型およびメソッドは使用できません。

型パラメータ

: TKey
キーの型。

: TValue
値の型。

解説

Dictionary.Enumerator.Current プロパティは、この型のインスタンスを返します。

C# 言語の foreach ステートメント (C++ の場合は for each、Visual Basic の場合は For Each) には、コレクション内の要素の型が必要です。IDictionary に基づくコレクションの各要素はキー/値ペアであるため、要素の型は、キーの型や値の型にはなりません。その代わり、要素の型は KeyValuePair になります。次に例を示します。

foreach (KeyValuePair<int, string>
 kvp in myDictionary) {...}

C++

for each (KeyValuePair<int, String^>
 kvp in myDictionary) {...}

Visual Basic

For Each kvp As KeyValuePair(Of
 Integer, String) In myDictionary
    ...
Next kvp

foreach ステートメントは、列挙子のラッパーです。これは、コレクションからの読み取りだけを許可し、コレクションへの書き込みを防ぎます。

使用例

KeyValuePair メソッドを使用してディクショナリのキーと値を列挙する方法を次のコード例に示します。

このコードは、Dictionary クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' When you use foreach to enumerate dictionary elements,
' the elements are retrieved as KeyValuePair objects.
Console.WriteLine()
For Each kvp As KeyValuePair(Of
 String, String) In openWith
    Console.WriteLine("Key = {0}, Value = {1}", _
        kvp.Key, kvp.Value)
Next kvp

// When you use foreach to enumerate dictionary elements,
// the elements are retrieved as KeyValuePair objects.
Console.WriteLine();
foreach( KeyValuePair<string, string>
 kvp in openWith )
{
    Console.WriteLine("Key = {0}, Value = {1}", 
        kvp.Key, kvp.Value);
}