Assembly : System (dans system.dll)
SyntaxePublic Function TryGetValue ( _ key As TKey, _ <OutAttribute> ByRef value As TValue _ ) As Boolean
Dim instance As SortedList(Of TKey, TValue) Dim key As TKey Dim value As TValue Dim returnValue As Boolean returnValue = instance.TryGetValue(key, value)
public bool TryGetValue ( TKey key, out TValue value )
public: virtual bool TryGetValue ( TKey key, [OutAttribute] TValue% value ) sealed
public final boolean TryGetValue (
TKey key,
/** @attribute OutAttribute() */ /** @ref */ TValue value
)
JScript ne prend pas en charge le passage d'arguments de type valeur par référence.
Paramètres
- key
Clé dont la valeur doit être obtenue.
- value
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
true si SortedList contient un élément correspondant à la clé spécifiée ; sinon, false.
NotesCette méthode combine la fonctionnalité de la méthode ContainsKey et de la propriété Item.
Si la clé est introuvable, le paramètre value reçoit la valeur par défaut appropriée pour le type valeur TValue ; par exemple, zéro (0) pour les types entiers, false pour les types booléens et référence Null (Nothing en Visual Basic) pour les types référence.
Cette méthode effectue une recherche binaire ; par conséquent, cette méthode est une opération O(log n), où n est égal à Count.
ExempleL'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 figurent pas dans la liste triée. À 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 développé fourni pour la classe SortedList.
' 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 <br /><span space="preserve">...</span><br /> ' 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
// 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."); } <br /><span space="preserve">...</span><br /> // 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."); }
Plates-formesWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Outils (masquer)
S'enregistrer
Liste des Membres
Qui est en ligne?
FAQ