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

Definição

Determina se a SortedList<TKey,TValue> contém uma chave específica.Determines whether the SortedList<TKey,TValue> contains a specific key.

public:
 virtual bool ContainsKey(TKey key);
public bool ContainsKey (TKey key);
abstract member ContainsKey : 'Key -> bool
override this.ContainsKey : 'Key -> bool
Public Function ContainsKey (key As TKey) As Boolean

Parâmetros

key
TKey

A chave a ser localizada no SortedList<TKey,TValue>.The key to locate in the SortedList<TKey,TValue>.

Retornos

true se o SortedList<TKey,TValue> contiver um elemento com a chave especificada; caso contrário, false.true if the SortedList<TKey,TValue> contains an element with the specified key; otherwise, false.

Implementações

Exceções

key é null.key is null.

Exemplos

O exemplo de código a seguir mostra como usar ContainsKey o método para testar se uma chave existe antes de chamar Add o método.The following code example shows how to use the ContainsKey method to test whether a key exists prior to calling the Add method. Ele também mostra como usar o TryGetValue método para recuperar valores, que é uma maneira eficiente de recuperar valores quando um programa tenta com frequência as chaves que não estão na lista classificada.It also shows how to use the TryGetValue method to retrieve values, which is an efficient way to retrieve values when a program frequently tries keys that are not in the sorted list. Por fim, ele mostra a maneira menos eficiente de testar se as chaves existem, usando Item[TKey] a propriedade (o indexador C#em).Finally, it shows the least efficient way to test whether keys exist, by using the Item[TKey] property (the indexer in C#).

Este exemplo de código faz parte de um exemplo maior fornecido para SortedList<TKey,TValue> a classe.This code example is part of a larger example provided for the SortedList<TKey,TValue> class.

// 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"]);
}
// 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"]);
}
' ContainsKey can be used to test keys before inserting 
' them.
If Not openWith.ContainsKey("ht") Then
    openWith.Add("ht", "hypertrm.exe")
    Console.WriteLine("Value added for key = ""ht"": {0}", _
        openWith("ht"))
End If
// When a program often has to try keys that turn out not to
// be in the list, TryGetValue can be a more efficient
// way to retrieve values.
String^ value = "";
if (openWith->TryGetValue("tif", value))
{
    Console::WriteLine("For key = \"tif\", value = {0}.", value);
}
else
{
    Console::WriteLine("Key = \"tif\" is not found.");
}
// When a program often has to try keys that turn out not to
// be in the list, 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.");
}
' When a program often has to try keys that turn out not to
' be in the list, TryGetValue can be a more efficient 
' way to retrieve values.
Dim value As String = ""
If openWith.TryGetValue("tif", value) Then
    Console.WriteLine("For key = ""tif"", value = {0}.", value)
Else
    Console.WriteLine("Key = ""tif"" is not found.")
End If
// The indexer throws an exception if the requested key is
// not in the list.
try
{
    Console::WriteLine("For key = \"tif\", value = {0}.",
        openWith["tif"]);
}
catch (KeyNotFoundException^)
{
    Console::WriteLine("Key = \"tif\" is not found.");
}
// The indexer throws an exception if the requested key is
// not in the list.
try
{
    Console.WriteLine("For key = \"tif\", value = {0}.", 
        openWith["tif"]);
}
catch (KeyNotFoundException)
{
    Console.WriteLine("Key = \"tif\" is not found.");
}
' The default Item property throws an exception if the requested
' key is not in the list.
Try
    Console.WriteLine("For key = ""tif"", value = {0}.", _
        openWith("tif"))
Catch 
    Console.WriteLine("Key = ""tif"" is not found.")
End Try

Comentários

Este método é uma operação O(log n), em que n é Count.This method is an O(log n) operation, where n is Count.

Aplica-se a

Veja também