OrderedDictionary.Item[] Propriété

public:
 property System::Object ^ default[int] { System::Object ^ get(int index); void set(int index, System::Object ^ value); };

public object this[int index] { get; set; }

member this.Item(int) : obj with get, set

Default Public Property Item(index As Integer) As Object

Paramètres

Valeur de propriété

Valeur de l’élément à l’index spécifié.

Implémente

Exceptions

Remarques

Cette propriété vous permet d’accéder à un élément spécifique dans la collection à l’aide de la syntaxe suivante : myCollection[index].

Le langage C# utilise ce mot clé pour définir les indexeurs au lieu d’implémenter la Item[] propriété. Visual Basic implémente Item[] en tant que propriété default qui fournit les mêmes fonctionnalités d’indexation.

public:
 property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };

public object this[object key] { get; set; }

member this.Item(obj) : obj with get, set

Default Public Property Item(key As Object) As Object

Paramètres

Valeur de propriété

Valeur associée à la clé spécifiée. Si la clé spécifiée est introuvable, la tentative d’obtention de la clé est retournée nullet la tentative de définition d’un élément à l’aide de la clé spécifiée.

Implémente

Exceptions

Exemples

L’exemple de code suivant illustre la modification d’une OrderedDictionary collection. Dans cet exemple, la Item[] propriété est utilisée pour modifier l’entrée de dictionnaire avec la clé "testKey2". Ce code fait partie d’un exemple de code plus large qui peut être consulté à l’adresse OrderedDictionary.

// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary.Contains("keyToDelete"))
    {
        myOrderedDictionary.Remove("keyToDelete");
    }
}

' Modifying the OrderedDictionary
If Not myOrderedDictionary.IsReadOnly Then

    ' Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1")

    ' Modify the value of the entry with the key "testKey2"
    myOrderedDictionary("testKey2") = "modifiedValue"

    ' Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1)

    ' Remove the "keyToDelete" entry, if it exists
    If (myOrderedDictionary.Contains("keyToDelete")) Then
        myOrderedDictionary.Remove("keyToDelete")
    End If
End If

Remarques

Cette propriété vous permet d’accéder à un élément spécifique dans la collection à l’aide de la syntaxe suivante : myCollection[key].

Vous pouvez également utiliser la Item[] propriété pour ajouter de nouveaux éléments en définissant la valeur d’une clé qui n’existe pas dans la OrderedDictionary collection (par exemple). myCollection["myNonexistentKey"] = myValue Toutefois, si la clé spécifiée existe déjà dans le OrderedDictionaryfichier , la définition de la Item[] propriété remplace l’ancienne valeur. En revanche, la Add méthode ne modifie pas les éléments existants.

Une clé ne peut pas être null, mais une valeur peut être. Pour faire la distinction entre null ce qui est retourné, car la clé spécifiée est introuvable et null retournée, car la valeur de la clé spécifiée est null, utilisez la Contains méthode pour déterminer si la clé existe dans le OrderedDictionary.