Partager via


OrderedDictionary.Item[] Propriété

Définition

Obtient ou définit la valeur spécifiée.

Surcharges

Item[Int32]

Obtient ou définit la valeur à l'index spécifié.

Item[Object]

Obtient ou définit la valeur avec la clé spécifiée.

Item[Int32]

Source:
OrderedDictionary.cs
Source:
OrderedDictionary.cs
Source:
OrderedDictionary.cs

Obtient ou définit la valeur à l'index spécifié.

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; }
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

index
Int32

Index de base zéro de la valeur à obtenir ou définir.

Valeur de propriété

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

Implémente

Exceptions

La propriété est en cours de définition et la collection OrderedDictionary est en lecture seule.

index est inférieur à zéro.

- ou -

index est supérieur ou égal à Count.

Remarques

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

Le langage C# utilise le mot clé this pour définir les indexeurs au lieu d’implémenter la Item[] propriété . Visual Basic implémente Item[] en tant que propriété par défaut, qui fournit la même fonctionnalité d’indexation.

S’applique à

Item[Object]

Source:
OrderedDictionary.cs
Source:
OrderedDictionary.cs
Source:
OrderedDictionary.cs

Obtient ou définit la valeur avec la clé spécifiée.

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; }
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

key
Object

Clé de la valeur à obtenir ou à définir.

Valeur de propriété

Valeur associée à la clé spécifiée. Si la clé spécifiée est introuvable, la tentative d'obtention retourne null et la tentative de définition crée un nouvel élément avec la clé spécifiée.

Implémente

Exceptions

La propriété est en cours de définition et la collection OrderedDictionary est en lecture seule.

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 du 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 (!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 de 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 , la OrderedDictionarydé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 l’être. Pour faire la distinction entre null qui est retourné parce que la clé spécifiée est introuvable et null qui est retournée parce que 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.

S’applique à