IDictionary<TKey,TValue>.ContainsKey(TKey) Método

Definição

Determina se o IDictionary<TKey,TValue> contém um elemento com a chave especificada.

public bool ContainsKey (TKey key);

Parâmetros

key
TKey

A chave a ser localizada no IDictionary<TKey,TValue>.

Retornos

true se o IDictionary<TKey,TValue> contiver um elemento com a chave; caso contrário, false.

Exceções

key é null.

Exemplos

O exemplo de código a seguir mostra como usar o ContainsKey método para testar se existe uma chave antes de chamar o Add método . Ele também mostra como usar o TryGetValue método , que pode ser uma maneira mais eficiente de recuperar valores se um programa frequentemente tenta valores de chave que não estão no dicionário. Por fim, ele mostra como inserir itens usando Item[] a propriedade (o indexador em C#).

Esse código faz parte de um exemplo maior que pode ser compilado e executado. Consulte System.Collections.Generic.IDictionary<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.");
}

Comentários

As implementações podem variar na forma como determinam a igualdade de objetos; por exemplo, a List<T> classe usa Comparer<T>.Default, enquanto a Dictionary<TKey,TValue> classe permite que o usuário especifique a IComparer<T> implementação a ser usada para comparar chaves.

As implementações podem variar se permitem key ser null.

Aplica-se a