KeyValuePair<TKey,TValue> Yapı

Tanım

Ad Alanı:

System.Collections.Generic

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

KeyValuePair.cs

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

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

public readonly struct KeyValuePair<TKey,TValue>

type KeyValuePair<'Key, 'Value> = struct

Public Structure KeyValuePair(Of TKey, TValue)

Tür Parametreleri

TKey

Anahtarın türü.

TValue

Değerin türü.

Devralma

Object

ValueType

KeyValuePair<TKey,TValue>

Örnekler

Aşağıdaki kod örneği, yapıyı kullanarak bir sözlükteki anahtarların ve değerlerin nasıl numaralandırılıp numaralandırılamını 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.

// 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

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) koleksiyondaki öğelerin türünde 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>. Örneğin:

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

foreach deyimi, numaralandırıcının etrafındaki bir sarmalayıcıdır ve bu, koleksiyona yazmanıza değil, yalnızca bu dosyadan okumaya izin verir.

Oluşturucular

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

Özellikler

Name	Description
Key	Anahtar/değer çiftindeki anahtarı alır.
Value	Anahtar/değer çiftindeki değeri alır.

Yöntemler

Name	Description
Deconstruct(TKey, TValue)	Geçerli KeyValuePair<TKey,TValue>öğesinin yapısını kaldırıyor.
ToString()	anahtarının KeyValuePair<TKey,TValue>ve değerinin dize gösterimlerini kullanarak öğesinin dize gösterimini döndürür.

Ayrıca bkz.

• IDictionary<TKey,TValue>
• Dictionary<TKey,TValue>.Enumerator
• DictionaryEntry