KeyValuePair<TKey,TValue> Struktura

Definicja

Definiuje parę klucz/wartość, którą można ustawić lub pobrać.

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

Parametry typu

TKey

Typ klucza.

TValue

Typ wartości.

Dziedziczenie
KeyValuePair<TKey,TValue>
Atrybuty

Przykłady

Poniższy przykład kodu przedstawia sposób wyliczania kluczy i wartości w słowniku KeyValuePair<TKey,TValue> przy użyciu struktury.

Ten kod jest częścią większego przykładu udostępnionego Dictionary<TKey,TValue> dla klasy.

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

Uwagi

Właściwość Dictionary<TKey,TValue>.Enumerator.Current zwraca wystąpienie tego typu.

Instrukcja foreach języka C# (for each w języku C++ For Each , w języku Visual Basic) zwraca obiekt typu elementów w kolekcji. Ponieważ każdy element kolekcji na IDictionary<TKey,TValue> podstawie jest parą klucz/wartość, typ elementu nie jest typem klucza ani typem wartości. Zamiast tego typ elementu to KeyValuePair<TKey,TValue>. Na przykład:

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

Instrukcja foreach jest otoką wokół modułu wyliczającego, który umożliwia odczytywanie tylko z, a nie zapisywania do kolekcji.

Konstruktory

KeyValuePair<TKey,TValue>(TKey, TValue)

Inicjuje KeyValuePair<TKey,TValue> nowe wystąpienie struktury przy użyciu określonego klucza i wartości.

Właściwości

Key

Pobiera klucz w parze klucz/wartość.

Value

Pobiera wartość w parze klucz/wartość.

Metody

Deconstruct(TKey, TValue)

Dekonstruktoruje bieżący KeyValuePair<TKey,TValue>element .

ToString()

Zwraca reprezentację KeyValuePair<TKey,TValue>ciągu elementu , używając reprezentacji ciągu klucza i wartości.

Dotyczy

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

Zobacz też