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

public bool TryGetValue(
	TKey key,
	out TValue value
)

Implémentations

Cette méthode combine la fonctionnalité de la méthode ContainsKey et de la propriété Item.

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

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

Cette méthode est proche d'une opération O(1).

L'exemple montre également comment utiliser la méthode TryGetValue comme un moyen plus efficace de récupérer des valeurs dans un programme qui essaye souvent des clés qui ne sont pas dans le dictionnaire. À des fins de comparaison, il montre également comment la propriété Item (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 classe Dictionary<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.");
}


...


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

.NET Framework

.NET Framework Client Profile

Bibliothèque de classes portable

.NET pour les applications du Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence