KeyValuePair

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

KeyValuePair コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定したキーと値を使用して、KeyValuePair 構造体の新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    key As TKey, _
    value As TValue _
)

Visual Basic (使用法)

Dim key As TKey
Dim value As TValue

Dim instance As New KeyValuePair(Of
 TKey, TValue)(key, value)

C#

public KeyValuePair (
    TKey key,
    TValue value
)

C++

public:
KeyValuePair (
    TKey key, 
    TValue value
)

J#

public KeyValuePair (
    TKey key, 
    TValue value
)

JScript

public function KeyValuePair (
    key : TKey, 
    value : TValue
)

パラメータ

key

キー/値ペアで定義されているオブジェクト。

value

key に関連付けられている定義。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
KeyValuePair ジェネリック構造体
KeyValuePair メンバ
System.Collections.Generic 名前空間

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)

C#

[SerializableAttribute] 
public struct KeyValuePair<TKey,TValue>

C++

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

J#

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

JScript

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

型パラメータ

TKey

キーの型。

TValue

値の型。

解説

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

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

C#

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

C#

// 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);
}

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
KeyValuePair メンバ
System.Collections.Generic 名前空間
IDictionary ジェネリック インターフェイス
Dictionary.Enumerator ジェネリック構造体
DictionaryEntry 構造体

KeyValuePair プロパティ

パブリック プロパティ

	名前	説明
	Value	キー/値ペア内の値を取得します。

参照

関連項目

KeyValuePair ジェネリック構造体
System.Collections.Generic 名前空間
IDictionary ジェネリック インターフェイス
Dictionary.Enumerator ジェネリック構造体
DictionaryEntry 構造体

KeyValuePair メソッド

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 ( ValueType から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 ( ValueType から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーライドされます。 キーと値の文字列形式を使用して、KeyValuePair の文字列形式を返します。

参照

関連項目

KeyValuePair ジェネリック構造体
System.Collections.Generic 名前空間
IDictionary ジェネリック インターフェイス
Dictionary.Enumerator ジェネリック構造体
DictionaryEntry 構造体

KeyValuePair メンバ

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

KeyValuePair ジェネリック型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	KeyValuePair	指定したキーと値を使用して、KeyValuePair 構造体の新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Value	キー/値ペア内の値を取得します。

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 ( ValueType から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 (ValueType から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーライドされます。 キーと値の文字列形式を使用して、KeyValuePair の文字列形式を返します。

参照

関連項目

KeyValuePair ジェネリック構造体
System.Collections.Generic 名前空間
IDictionary ジェネリック インターフェイス
Dictionary.Enumerator ジェネリック構造体
DictionaryEntry 構造体