Auf Englisch lesen

Freigeben über


KeyValuePair<TKey,TValue> Struktur

Definition

Definiert ein Schlüssel-Wert-Paar, das festgelegt oder abgerufen werden kann.

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

Typparameter

TKey

Der Typ des Schlüssels.

TValue

Der Typ des Werts.

Vererbung
KeyValuePair<TKey,TValue>
Attribute

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die Schlüssel und Werte in einem Wörterbuch mithilfe der KeyValuePair<TKey,TValue> -Struktur aufgezählt werden.

Dieser Code ist Teil eines größeren Beispiels für die Dictionary<TKey,TValue> -Klasse.

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

Hinweise

Die Dictionary<TKey,TValue>.Enumerator.Current -Eigenschaft gibt einen instance dieses Typs zurück.

Die foreach -Anweisung der C#-Sprache (for each in C++, For Each in Visual Basic) gibt ein Objekt vom Typ der Elemente in der Auflistung zurück. Da jedes Element einer Auflistung basierend auf IDictionary<TKey,TValue> ein Schlüssel-Wert-Paar ist, ist der Elementtyp nicht der Typ des Schlüssels oder der Typ des Werts. Stattdessen ist KeyValuePair<TKey,TValue>der Elementtyp . Beispiel:

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

Die foreach -Anweisung ist ein Wrapper um den Enumerator, der nur das Lesen und nicht das Schreiben in die Auflistung zulässt.

Konstruktoren

KeyValuePair<TKey,TValue>(TKey, TValue)

Initialisiert eine neue Instanz der KeyValuePair<TKey,TValue>-Struktur mit dem angegebenen Schlüssel und Wert.

Eigenschaften

Key

Ruft den Schlüssel im Schlüssel-Wert-Paar ab.

Value

Ruft den Wert im Schlüssel-Wert-Paar ab.

Methoden

Deconstruct(TKey, TValue)

Dekonstruiert die aktuelle KeyValuePair<TKey,TValue>-Struktur.

ToString()

Gibt eine Zeichenfolgenentsprechung des KeyValuePair<TKey,TValue> zurück, wobei die Zeichenfolgenentsprechungen des Schlüssels und des Werts verwendet werden.

Gilt für:

Produkt Versionen
.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

Weitere Informationen