İngilizce dilinde oku

Aracılığıyla paylaş


KeyValuePair<TKey,TValue> Yapı

Tanım

Ayarlanabilen veya alınabilen bir anahtar/değer çifti tanımlar.

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

Tür Parametreleri

TKey

Anahtarın türü.

TValue

Değerin türü.

Devralma
KeyValuePair<TKey,TValue>
Öznitelikler

Örnekler

Aşağıdaki kod örneği, bir sözlükteki anahtarların ve değerlerin yapısını kullanarak nasıl numaralandırılıp listelenmeyi KeyValuePair<TKey,TValue> gösterir.

Bu kod, sınıfı için Dictionary<TKey,TValue> sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Dictionary<TKey,TValue>.Enumerator.Current özelliği bu türün bir örneğini döndürür.

foreach C# dilinin deyimi (for eachVisual Basic'te C++For Each'da), koleksiyondaki öğelerin türüne ait bir nesne döndürür. Tabanlı IDictionary<TKey,TValue> bir koleksiyonun her öğesi bir anahtar/değer çifti olduğundan, öğe türü anahtarın türü veya değerin türü değildir. Bunun yerine, öğe türü şeklindedir KeyValuePair<TKey,TValue>. Örnek:

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

deyimi foreach , numaralandırıcının çevresindeki bir sarmalayıcıdır ve koleksiyona yazmadan yalnızca buradan okumaya izin verir.

Oluşturucular

KeyValuePair<TKey,TValue>(TKey, TValue)

Belirtilen anahtar ve değerle yapının yeni bir örneğini KeyValuePair<TKey,TValue> başlatır.

Özellikler

Key

Anahtar/değer çiftindeki anahtarı alır.

Value

Anahtar/değer çiftindeki değeri alır.

Yöntemler

Deconstruct(TKey, TValue)

Geçerli KeyValuePair<TKey,TValue>öğesinin yapısından çıkar.

ToString()

Anahtarın ve değerin KeyValuePair<TKey,TValue>dize gösterimlerini kullanarak öğesinin dize gösterimini döndürür.

Şunlara uygulanır

Ürün Sürümler
.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

Ayrıca bkz.