Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Dictionary<TKey, TValue>.TryGetValue-Methode: (TKey, TValue)

 

Veröffentlicht: Oktober 2016

Ruft den dem angegebenen Schlüssel zugeordneten Wert ab.

Namespace:   System.Collections.Generic
Assembly:  mscorlib (in mscorlib.dll)

public bool TryGetValue(
	TKey key,
	out TValue value
)

Parameter

key
Type: TKey

Der Schlüssel des abzurufenden Werts.

value
Type: TValue

Enthält nach dem Beenden dieser Methode den Wert, der dem angegebenen Schlüssel zugeordnet ist, wenn der Schlüssel gefunden wurde, oder andernfalls den Standardwert für den Typ des value-Parameters. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Type: System.Boolean

true, wenn das Dictionary<TKey, TValue> ein Element mit dem angegebenen Schlüssel enthält, andernfalls false.

Exception Condition
ArgumentNullException

key ist null.

Diese Methode kombiniert die Funktionalität der ContainsKey -Methode und der Item Eigenschaft.

Wenn der Schlüssel nicht gefunden wird, wird die value Parameter Ruft den entsprechenden Standardwert für den Typ TValuez. B. 0 (null) für Ganzzahltypen, false für boolesche Typen und null für Verweistypen.

Verwenden der TryGetValue Methode, wenn im Code häufig versucht, auf Schlüssel zuzugreifen, die nicht im Wörterbuch enthalten sind. Mit dieser Methode ist effizienter als das Abfangen der KeyNotFoundException ausgelöst, durch die Item Eigenschaft.

Diese Methode wird annähernd in O(1) ausgeführt

Das Beispiel zeigt, wie Sie die TryGetValue Methode als eine effizientere Methode zum Abrufen von Werten in einem Programm, das häufig versucht, auf Schlüssel zuzugreifen, die nicht im Wörterbuch enthalten sind. Im Beispiel wird auch gezeigt, wie die Item -Eigenschaft (Indexer in c#) löst Ausnahmen aus, wenn Sie versuchen, nicht vorhandene Schlüssel abzurufen.

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die Dictionary<TKey, TValue> Klasse (openWith ist der Name des Wörterbuchs in diesem Beispiel verwendet).

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

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 2.0
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: