SortedList<TKey,TValue>.TryGetValue(TKey, TValue) Metod

Definition

Namnområde:
System.Collections.Generic
Sammansättningar:
System.dll, System.Collections.dll
Sammansättning:
System.dll
Sammansättning:
System.Collections.dll
Sammansättning:
netstandard.dll

Hämtar värdet som är associerat med den angivna nyckeln.

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

Parametrar

key
TKey

Nyckeln vars värde ska hämtas.

value
TValue

När den här metoden returnerar, det värde som är associerat med den angivna nyckeln, om nyckeln hittas; annars standardvärdet för parametertypen value . Den här parametern skickas oinitierad.

Returer

Boolean

true SortedList<TKey,TValue> om innehåller ett element med den angivna nyckeln, annars . false

Implementeringar

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

Undantag

ArgumentNullException

key är null.

Exempel

Exemplet visar hur du använder TryGetValue metoden som ett effektivare sätt att hämta värden i ett program som ofta försöker använda nycklar som inte finns i den sorterade listan. Exemplet visar däremot också hur Item[] egenskapen (indexeraren i C#) genererar undantag när du försöker hämta obefintliga nycklar.

Det här kodexemplet är en del av ett större exempel för SortedList<TKey,TValue> klassen.

// 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

// 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.
match openWith.TryGetValue("tif") with
| true, value ->
    printfn "For key = \"tif\", value = {value}."
| false, _ ->
    printfn "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

// The indexer throws an exception if the requested key is
// not in the list.
try
    printfn $"""For key = "tif", value = {openWith["tif"]}."""
with 
    | :? KeyNotFoundException ->
        printfn "Key = \"tif\" is not found."

Kommentarer

Den här metoden kombinerar funktionerna i ContainsKey metoden och egenskapen Item[] .

Om nyckeln inte hittas hämtar parametern value lämpligt standardvärde för värdetypen TValue, till exempel noll (0) för heltalstyper, false för booleska typer och null för referenstyper.

Den här metoden utför en binär sökning. Därför är den här metoden en O(log n)-åtgärd, där n är Count.

Gäller för

Se även