Assembly : System (dans system.dll)
SyntaxePublic Default Property Item ( _ key As TKey _ ) As TValue
Dim instance As SortedList(Of TKey, TValue) Dim key As TKey Dim value As TValue value = instance(key) instance(key) = value
public TValue this [ TKey key ] { get; set; }
public: virtual property TValue default [TKey] { TValue get (TKey key) sealed; void set (TKey key, TValue value) sealed; }
/** @property */ public final TValue get_Item (TKey key) /** @property */ public final void set_Item (TKey key, TValue value)
J# prend en charge l'utilisation de propriétés indexées mais pas la déclaration de nouvelles propriétés indexées.
Paramètres
- key
Clé dont la valeur doit être obtenue ou définie.
Valeur de la propriété
Valeur associée à la clé spécifiée. Si la clé spécifiée est introuvable, une opération Get retourne KeyNotFoundException et une opération Set crée un nouvel élément à l'aide de la clé spécifiée.
Exceptions
NotesCette propriété permet d'accéder à un élément spécifique dans la collection en utilisant la syntaxe suivante : myCollection[key].
Une clé ne peut pas être référence Null (Nothing en Visual Basic), mais une valeur peut l'être si le type des valeurs de la liste, TValue, est un type référence.
Si la clé est introuvable, cette propriété retourne 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.
Vous pouvez aussi utiliser la propriété Item pour ajouter de nouveaux éléments en définissant la valeur d'une clé qui n'existe pas dans SortedList ; par exemple, myCollection["myNonexistentKey"] = myValue. Cependant, si la clé spécifiée existe déjà dans SortedList, la définition de la propriété Item remplace l'ancienne valeur. Par contre, la méthode Add ne modifie pas les éléments existants.
La récupération de la valeur de cette propriété est une opération O(log n), où n est Count. La définition de la propriété est une opération O(log n) si la clé est déjà dans SortedList. Si la clé n'est pas dans la liste, la définition de la propriété est une opération O(n) pour les données non triées, ou O(log n) si le nouvel élément est ajouté à la fin de la liste. Si l'insertion conduit à un redimensionnement, l'opération est O(n).
ExempleL'exemple de code suivant utilise la propriété Item (l'indexeur en C#) pour récupérer des valeurs, démontrant qu'une KeyNotFoundException est levée lorsqu'une clé demandée n'est pas présente et indiquant que la valeur associée à une clé peut être remplacée.
L'exemple montre également comment utiliser la méthode TryGetValue comme un moyen plus efficace de récupérer des valeurs si un programme doit souvent essayer des valeurs de clés qui ne figurent pas dans la liste triée.
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
// 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."); }
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