KeyValuePair<TKey,TValue> Structure

Référence

Définition

Espace de noms:: System.Collections.Generic

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: KeyValuePair.cs

Source:: KeyValuePair.cs

Source:: KeyValuePair.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Définit une paire clé/valeur qui peut être définie ou récupérée.

generic <typename TKey, typename TValue>
public value class KeyValuePair

public struct KeyValuePair<TKey,TValue>

public readonly struct KeyValuePair<TKey,TValue>

[System.Serializable]
public struct KeyValuePair<TKey,TValue>

type KeyValuePair<'Key, 'Value> = struct

[<System.Serializable>]
type KeyValuePair<'Key, 'Value> = struct

Public Structure KeyValuePair(Of TKey, TValue)

Paramètres de type

TKey

Type de la clé.

TValue

Type de la valeur.

Héritage: Object

ValueType
KeyValuePair<TKey,TValue>

Attributs: SerializableAttribute

Exemples

L’exemple de code suivant montre comment énumérer les clés et les valeurs dans un dictionnaire, à l’aide de la KeyValuePair<TKey,TValue> structure .

Ce code fait partie d’un exemple plus large fourni pour la Dictionary<TKey,TValue> classe .

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

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

' 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

Remarques

La Dictionary<TKey,TValue>.Enumerator.Current propriété retourne une instance de ce type.

L’instruction foreach du langage C# (for each en C++, For Each en Visual Basic) retourne un objet du type des éléments de la collection. Étant donné que chaque élément d’une collection basée sur IDictionary<TKey,TValue> est une paire clé/valeur, le type d’élément n’est pas le type de la clé ou le type de la valeur. Au lieu de cela, le type d’élément est KeyValuePair<TKey,TValue>. Exemple :

for each(KeyValuePair<String^, String^> kvp in myDictionary)
{
    Console::WriteLine("Key = {0}, Value = {1}", kvp.Key, kvp.Value);
}

foreach( KeyValuePair<string, string> kvp in myDictionary )
{
    Console.WriteLine("Key = {0}, Value = {1}", kvp.Key, kvp.Value);
}

For Each kvp As KeyValuePair(Of String, String) In myDictionary
    Console.WriteLine("Key = {0}, Value = {1}", kvp.Key, kvp.Value)
Next kvp

L’instruction foreach est un wrapper autour de l’énumérateur, qui autorise uniquement la lecture à partir de la collection, et non l’écriture dans.

Constructeurs

KeyValuePair<TKey,TValue>(TKey, TValue)

Initialise une nouvelle instance de la structure KeyValuePair<TKey,TValue> avec la valeur et la clé spécifiées.

Propriétés

Key	Obtient la clé de la paire clé/valeur.
Value	Obtient la valeur de la paire clé/valeur.

Méthodes

Deconstruct(TKey, TValue)	Déconstruit le KeyValuePair<TKey,TValue> actuel.
ToString()	Retourne une représentation sous forme de chaîne de KeyValuePair<TKey,TValue>, à l’aide des représentations sous forme de chaîne de la clé et la valeur.

S’applique à

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Partager via