OrderedDictionary.Item[] Eigenschap

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

Parameters

Waarde van eigenschap

De waarde van het item op de opgegeven index.

Implementeringen

Uitzonderingen

Opmerkingen

Met deze eigenschap kunt u toegang krijgen tot een specifiek element in de verzameling met behulp van de volgende syntaxis: myCollection[index]

De C#-taal gebruikt dit trefwoord om de indexeerfuncties te definiëren in plaats van de Item[] eigenschap te implementeren. Visual Basic implementeert Item[] als een eigenschap default, die dezelfde indexeringsfunctionaliteit biedt.

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

Parameters

Waarde van eigenschap

De waarde die is gekoppeld aan de opgegeven sleutel. Als de opgegeven sleutel niet wordt gevonden, wordt geprobeerd deze terug nullte krijgen en wordt er een nieuw element gemaakt met behulp van de opgegeven sleutel.

Implementeringen

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u de wijziging van een OrderedDictionary verzameling. In dit voorbeeld wordt de eigenschap gebruikt om de Item[] woordenlijstvermelding met de sleutel "testKey2"te wijzigen. Deze code maakt deel uit van een groter codevoorbeeld dat kan worden bekeken op 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

Opmerkingen

Met deze eigenschap kunt u toegang krijgen tot een specifiek element in de verzameling met behulp van de volgende syntaxis: myCollection[key]

U kunt de Item[] eigenschap ook gebruiken om nieuwe elementen toe te voegen door de waarde in te stellen van een sleutel die niet bestaat in de OrderedDictionary verzameling (bijvoorbeeld myCollection["myNonexistentKey"] = myValue). Als de opgegeven sleutel echter al bestaat in de OrderedDictionaryeigenschap, wordt de oude waarde overschreven door de Item[] eigenschap in te stellen. De methode wijzigt daarentegen Add geen bestaande elementen.

Een sleutel kan niet zijn null, maar een waarde kan zijn. Als u onderscheid wilt maken tussen null die sleutel omdat de opgegeven sleutel niet wordt gevonden en null die wordt geretourneerd omdat de waarde van de opgegeven sleutel is null, gebruikt u de Contains methode om te bepalen of de sleutel in de OrderedDictionarysleutel bestaat.