Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método Dictionary<TKey, TValue>.ContainsKey

Determina se Dictionary<TKey, TValue> contém a chave especificada.

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

public bool ContainsKey(
	TKey key
)

Parâmetros

key
Tipo: TKey
A chave para localizar em Dictionary<TKey, TValue>.

Valor de retorno

Tipo: System.Boolean
true se Dictionary<TKey, TValue> contém um elemento com a chave especificada; caso contrário, false.

Implementações

IDictionary<TKey, TValue>.ContainsKey(TKey)
IReadOnlyDictionary<TKey, TValue>.ContainsKey(TKey)

ExceçãoCondição
ArgumentNullException

key é null.

Este método abrange uma operação O(1).

O exemplo de código a seguir mostra como usar o método de ContainsKey para testar se uma chave existe antes da chamada do método Add . Também mostra como usar o método de TryGetValue para recuperar valores, que é uma maneira eficiente para recuperar valores quando um programa tenta geralmente as chaves que não estão no dicionário. Finalmente, mostra maneira menos eficiente para testar se as teclas existem, usando a propriedade do indexador Item (em C#).

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


// ContainsKey can be used to test keys before inserting 
// them.
if (!openWith.ContainsKey("ht"))
{
    openWith.Add("ht", "hypertrm.exe");
    Console.WriteLine("Value added for key = \"ht\": {0}", 
        openWith["ht"]);
}


...


// When a program often has to try keys that turn out not to
// be in the dictionary, TryGetValue can be a more efficient 
// way to retrieve values.
string value = "";
if (openWith.TryGetValue("tif", out value))
{
    Console.WriteLine("For key = \"tif\", value = {0}.", value);
}
else
{
    Console.WriteLine("Key = \"tif\" is not found.");
}


...


// The indexer throws an exception if the requested key is
// not in the dictionary.
try
{
    Console.WriteLine("For key = \"tif\", value = {0}.", 
        openWith["tif"]);
}
catch (KeyNotFoundException)
{
    Console.WriteLine("Key = \"tif\" is not found.");
}


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft