Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Dictionary<TKey, TValue>.TryGetValue méthode (TKey, TValue)

 

Date de publication : novembre 2016

Obtient la valeur associée à la clé spécifiée.

Espace de noms:   System.Collections.Generic
Assembly:  mscorlib (dans mscorlib.dll)

public bool TryGetValue(
	TKey key,
	out TValue value
)

Paramètres

key
Type: TKey

Clé de la valeur à obtenir.

value
Type: TValue

Cette méthode retourne la valeur associée à la clé spécifiée si la clé est trouvée ; sinon, retourne la valeur par défaut pour le type du paramètre value. Ce paramètre est passé sans être initialisé.

Valeur de retour

Type: System.Boolean

true si Dictionary<TKey, TValue> contient un élément correspondant à la clé spécifiée ; sinon, false.

Exception Condition
ArgumentNullException

key a la valeur null.

Cette méthode combine les fonctionnalités de la ContainsKey (méthode) et le Item propriété.

Si la clé est introuvable, la value paramètre reçoit la valeur par défaut appropriée pour le type TValue; par exemple, 0 (zéro) pour les types entiers, false pour les types booléens, et null pour les types référence.

Utilisez la TryGetValue méthode si votre code tente fréquemment d’accéder aux clés qui ne sont pas dans le dictionnaire. À l’aide de cette méthode est plus efficace que d’intercepter le KeyNotFoundException levée par le Item propriété.

Cette méthode est proche d’une opération o (1).

L’exemple montre comment utiliser le TryGetValue méthode comme un moyen plus efficace pour récupérer des valeurs dans un programme qui essaye souvent des clés qui ne sont pas dans le dictionnaire. Contraste, l’exemple montre également comment la Item propriété (l’indexeur en c#) lève des exceptions lors de la tentative de récupération de clés inexistantes.

Cet exemple de code fait partie d’un exemple plus complet fourni pour la Dictionary<TKey, TValue> classe (openWith est le nom du dictionnaire utilisé dans cet exemple).

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

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 2.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: