SortedDictionary<TKey,TValue>.TryGetValue(TKey, TValue) Metoda

Reference

Definice

Obor názvů:: System.Collections.Generic

Sestavení:: System.Collections.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Zdroj:: SortedDictionary.cs

Zdroj:: SortedDictionary.cs

Zdroj:: SortedDictionary.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá hodnotu přidruženou k zadanému klíči.

public:
 virtual bool TryGetValue(TKey key, [Runtime::InteropServices::Out] TValue % value);

public bool TryGetValue (TKey key, out TValue value);

abstract member TryGetValue : 'Key * 'Value -> bool
override this.TryGetValue : 'Key * 'Value -> bool

Public Function TryGetValue (key As TKey, ByRef value As TValue) As Boolean

Parametry

key: TKey

Klíč hodnoty, kterou chcete získat

value: TValue

Když tato metoda vrátí hodnotu přidruženou k zadanému klíči, pokud je nalezen klíč; v opačném případě výchozí hodnota pro typ parametru value .

Návraty

Boolean

true pokud obsahuje SortedDictionary<TKey,TValue> prvek se zadaným klíčem, falsev opačném případě .

Implementuje

TryGetValue(TKey, TValue) TryGetValue(TKey, TValue)

Výjimky

ArgumentNullException

key je null.

Příklady

Příklad ukazuje, jak použít metodu TryGetValue jako efektivnější způsob načtení hodnot v programu, který často zkouší klíče, které nejsou ve slovníku. Naproti tomu příklad také ukazuje, jak Item[] vlastnost (indexer v jazyce C#) vyvolává výjimky při pokusu o načtení neexistujících klíčů.

Tento příklad kódu je součástí většího příkladu SortedDictionary<TKey,TValue> pro třídu.

// 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.");
}

' 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.
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 dictionary.
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 dictionary.
Try
    Console.WriteLine("For key = ""tif"", value = {0}.", _
        openWith("tif"))
Catch 
    Console.WriteLine("Key = ""tif"" is not found.")
End Try

Poznámky

Tato metoda kombinuje funkce ContainsKey metody a Item[] vlastnosti.

Pokud klíč není nalezen, value získá parametr odpovídající výchozí hodnotu pro typ TValuehodnoty, například 0 (nula) pro celočíselné typy, false pro logické typy a null pro odkazové typy.

Tato metoda je operace O(log n).

Platí pro