IDictionary<TKey,TValue>.TryGetValue(TKey, TValue) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de waarde op die is gekoppeld aan de opgegeven sleutel.
public:
bool TryGetValue(TKey key, [Runtime::InteropServices::Out] TValue % value);public bool TryGetValue(TKey key, out TValue value);abstract member TryGetValue : 'Key * 'Value -> boolPublic Function TryGetValue (key As TKey, ByRef value As TValue) As BooleanParameters
- key
- TKey
De sleutel waarvan de waarde moet worden opgehaald.
- value
- TValue
Wanneer deze methode wordt geretourneerd, wordt de waarde die is gekoppeld aan de opgegeven sleutel, als de sleutel wordt gevonden; anders is de standaardwaarde voor het type van de value parameter. Deze parameter wordt niet-geïnitialiseerd doorgegeven.
Retouren
true als het object dat wordt geïmplementeerd IDictionary<TKey,TValue> , een element met de opgegeven sleutel bevat; falseanders.
Uitzonderingen
key is null.
Voorbeelden
In het voorbeeld ziet u hoe u de TryGetValue methode gebruikt om waarden op te halen. Als een programma vaak sleutelwaarden probeert die zich niet in een woordenlijst bevinden, kan de TryGetValue methode efficiënter zijn dan het gebruik van de Item[] eigenschap (de indexeerfunctie in C#), die uitzonderingen genereert bij het ophalen van niet-bestaande sleutels.
Deze code maakt deel uit van een groter voorbeeld dat kan worden gecompileerd en uitgevoerd. Zie System.Collections.Generic.IDictionary<TKey,TValue>.
// 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
Opmerkingen
Deze methode combineert de functionaliteit van de ContainsKey methode en de Item[] eigenschap.
Als de sleutel niet wordt gevonden, krijgt de value parameter de juiste standaardwaarde voor het type TValue, bijvoorbeeld nul (0) voor gehele getallen, false voor Booleaanse typen en null voor verwijzingstypen.