KeyValuePair<TKey,TValue> Struktur
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert ein Schlüssel-Wert-Paar, das festgelegt oder abgerufen werden kann.
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)
Typparameter
- TKey
Der Typ des Schlüssels.
- TValue
Der Typ des Werts.
- Vererbung
- Attribute
Beispiele
Im folgenden Codebeispiel wird gezeigt, wie Sie die Schlüssel und Werte in einem Wörterbuch mithilfe der KeyValuePair<TKey,TValue> Struktur aufzählen.
Dieser Code ist Teil eines größeren Beispiels, das für die Dictionary<TKey,TValue> Klasse bereitgestellt wird.
// 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
Hinweise
Die Dictionary<TKey,TValue>.Enumerator.Current Eigenschaft gibt eine Instanz dieses Typs zurück.
Die foreach Anweisung der C#-Sprache (For Each in Visual Basic) gibt ein Objekt des Typs der Elemente in der Auflistung zurück. Da jedes Element einer Auflistung IDictionary<TKey,TValue> ein Schlüssel-Wert-Paar ist, ist der Elementtyp nicht der Typ des Schlüssels oder des Typs des Werts. Stattdessen lautet KeyValuePair<TKey,TValue>der Elementtyp . Beispiel:
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
Die foreach Anweisung ist ein Wrapper um den Enumerator, der nur das Lesen von , nicht schreiben in die Auflistung ermöglicht.
Konstruktoren
| Name | Beschreibung |
|---|---|
| KeyValuePair<TKey,TValue>(TKey, TValue) |
Initialisiert eine neue Instanz der KeyValuePair<TKey,TValue> Struktur mit dem angegebenen Schlüssel und Wert. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Key |
Ruft den Schlüssel im Schlüssel-Wert-Paar ab. |
| Value |
Ruft den Wert im Schlüssel-Wert-Paar ab. |
Methoden
| Name | Beschreibung |
|---|---|
| Deconstruct(TKey, TValue) |
Deconstructs the current KeyValuePair<TKey,TValue>. |
| ToString() |
Gibt eine Zeichenfolgendarstellung des KeyValuePair<TKey,TValue>Schlüssels und Werts mithilfe der Zeichenfolgendarstellungen zurück. |