KeyValuePair<TKey,TValue> Estrutura

Referência

Definição

Namespace:: System.Collections.Generic

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origem:: KeyValuePair.cs

Origem:: KeyValuePair.cs

Origem:: KeyValuePair.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define um par chave/valor que pode ser definido ou recuperado.

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)

Parâmetros de tipo

TKey

Tipo da chave.

TValue

Tipo do valor.

Herança: Object

ValueType
KeyValuePair<TKey,TValue>

Atributos: SerializableAttribute

Exemplos

O exemplo de código a seguir mostra como enumerar as chaves e os valores em um dicionário, usando a KeyValuePair<TKey,TValue> estrutura .

Esse código faz parte de um exemplo maior fornecido para a Dictionary<TKey,TValue> classe .

// When you use foreach to enumerate dictionary elements,
// the elements are retrieved as KeyValuePair objects.
Console::WriteLine();
for each( 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();
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

Comentários

A Dictionary<TKey,TValue>.Enumerator.Current propriedade retorna uma instância desse tipo.

A foreach instrução da linguagem C# (for each em C++, For Each no Visual Basic) retorna um objeto do tipo dos elementos na coleção. Como cada elemento de uma coleção baseada em IDictionary<TKey,TValue> é um par chave/valor, o tipo de elemento não é o tipo da chave ou o tipo do valor. Em vez disso, o tipo de elemento é KeyValuePair<TKey,TValue>. Por exemplo:

for each(KeyValuePair<String^, String^> kvp in myDictionary)
{
    Console::WriteLine("Key = {0}, Value = {1}", kvp.Key, kvp.Value);
}

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

A foreach instrução é um wrapper em torno do enumerador, que permite apenas a leitura, não a gravação em, a coleção.

Construtores

KeyValuePair<TKey,TValue>(TKey, TValue)

Inicializa uma nova instância da estrutura KeyValuePair<TKey,TValue> com a chave e o valor especificados.

Propriedades

Key	Obtém a chave do par chave/valor.
Value	Obtém o valor no par chave/valor.

Métodos

Deconstruct(TKey, TValue)	Desconstrói o KeyValuePair<TKey,TValue> atual.
ToString()	Retorna uma representação de cadeia de caracteres do KeyValuePair<TKey,TValue>, usando as representações de cadeia de caracteres da chave e do valor.

Aplica-se a

Produto	Versões
.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

Partilhar via