Public Default Property Item ( _
    key As TKey _
) As TValue

Dim instance As SortedDictionary(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é de la valeur à obtenir ou à définir.

Valeur de la propriété

Cette propriété permet d'accéder à un élément spécifique dans la collection en utilisant la syntaxe C# suivante : myCollection[key] (myCollection(key) en Visual Basic).

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 SortedDictionary ; par exemple, myCollection["myNonexistentKey"] = myValue. Cependant, si la clé spécifiée existe déjà dans SortedDictionary, 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.

Une clé ne peut pas être référence Null (Nothing en Visual Basic), mais une valeur peut l'être, si le type valeur TValue est un type référence.

L'obtention de la valeur de cette propriété est une opération O(log n), tout comme la définition de la propriété.

L'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 sont pas dans le dictionnaire.

Cet exemple de code fait partie d'un exemple plus développé fourni pour la classe SortedDictionary.

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

Windows 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.

.NET Framework