Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Estrutura KeyValuePair<TKey, TValue>

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Collections.Generic
Assembly:  mscorlib (em mscorlib.dll)

[SerializableAttribute]
public struct KeyValuePair<TKey, TValue>

Parâmetros de Tipo

TKey

Tipo da chave.

TValue

Tipo do valor.

NomeDescrição
System_CAPS_pubmethodKeyValuePair<TKey, TValue>(TKey, TValue)

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

NomeDescrição
System_CAPS_pubpropertyKey

Obtém a chave do par chave/valor.

System_CAPS_pubpropertyValue

Obtém o valor no par chave/valor.

NomeDescrição
System_CAPS_pubmethodEquals(Object)

Indica se essa instância e um objeto especificado são iguais.(Herdado de ValueType.)

System_CAPS_pubmethodGetHashCode()

Retorna o código hash para essa instância.(Herdado de ValueType.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

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.(Substitui o ValueType.ToString().)

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

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

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

O foreach instrução é um wrapper em torno de enumerador, que permite que somente leitura de não gravar à coleção.

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

Esse código é 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();
foreach( KeyValuePair<string, string> kvp in openWith )
{
    Console.WriteLine("Key = {0}, Value = {1}", 
        kvp.Key, kvp.Value);
}

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 2.0
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: