OrderedDictionary.Item[] Egenskap

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

Parametrar

Egenskapsvärde

Värdet för objektet i det angivna indexet.

Implementeringar

Undantag

Kommentarer

Med den här egenskapen kan du komma åt ett specifikt element i samlingen med hjälp av följande syntax: myCollection[index].

C#-språket använder det här nyckelordet för att definiera indexerarna i stället för att Item[] implementera egenskapen. Visual Basic implementerar Item[] som en default-egenskap, vilket ger samma indexeringsfunktion.

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

Parametrar

Egenskapsvärde

Värdet som är associerat med den angivna nyckeln. Om den angivna nyckeln inte hittas returnerar nullförsök att hämta den och försöker ange det ett nytt element med den angivna nyckeln.

Implementeringar

Undantag

Exempel

Följande kodexempel visar hur en OrderedDictionary samling har ändrats. I det här exemplet används egenskapen Item[] för att ändra ordlisteposten med nyckeln "testKey2". Den här koden är en del av ett större kodexempel som kan visas på 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

Kommentarer

Med den här egenskapen kan du komma åt ett specifikt element i samlingen med hjälp av följande syntax: myCollection[key].

Du kan också använda Item[] egenskapen för att lägga till nya element genom att ange värdet för en nyckel som inte finns i OrderedDictionary samlingen (till exempel myCollection["myNonexistentKey"] = myValue). Men om den angivna nyckeln redan finns i OrderedDictionary, skriver egenskapen Item[] över det gamla värdet. Metoden ändrar däremot Add inte befintliga element.

En nyckel kan inte vara null, men ett värde kan vara. Om du vill skilja mellan null som returneras eftersom den angivna nyckeln inte hittas och null som returneras eftersom värdet för den angivna nyckeln är nullanvänder du Contains metoden för att avgöra om nyckeln finns i OrderedDictionary.