OrderedDictionary.Item[] Eigenschaft

Definition

Namespace:

System.Collections.Specialized

Assemblys:

System.dll, System.Collections.Specialized.dll

Assembly:

System.Collections.Specialized.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Ruft den angegebenen Wert ab oder legt diesen fest.

Überlädt

Item[Int32]	Ruft den Wert am angegebenen Index ab oder legt diesen fest.
Item[Object]	Ruft den Wert mit dem angegebenen Schlüssel ab oder legt diesen fest.

Item[Int32]

Ruft den Wert am angegebenen Index ab oder legt diesen fest.

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

Parameter

index

Int32

Der nullbasierte Index des Werts, der abgerufen oder festgelegt werden soll.

Eigenschaftswert

Object

Der Wert des Elements am angegebenen Index.

Implementiert

Item[Int32]

Ausnahmen

NotSupportedException

Die Eigenschaft wird festgelegt, und die OrderedDictionary-Auflistung ist schreibgeschützt.

ArgumentOutOfRangeException

index ist kleiner als Null.

- oder - index ist größer oder gleich Count.

Hinweise

Mit dieser Eigenschaft können Sie mithilfe der folgenden Syntax auf ein bestimmtes Element in der Auflistung zugreifen: myCollection[index]

Die C#-Sprache verwendet dieses Schlüsselwort, um die Indexer zu definieren, anstatt die Item[] Eigenschaft zu implementieren. Visual Basic implementiert als Standardeigenschaft, die dieselbe Indizierungsfunktion Item[] bereitstellt.

Item[Object]

Ruft den Wert mit dem angegebenen Schlüssel ab oder legt diesen fest.

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

Parameter

key

Object

Der Schlüssel des abzurufenden oder festzulegenden Werts.

Eigenschaftswert

Object

Der dem angegebenen Schlüssel zugeordnete Wert. Wenn der angegebene Schlüssel nicht gefunden werden kann, wird beim Abrufen dieses Schlüssels null zurückgegeben. Beim Festlegen wird ein neues Element mit dem angegebenen Schlüssel erstellt.

Implementiert

Item[Object]

Ausnahmen

NotSupportedException

Die Eigenschaft wird festgelegt, und die OrderedDictionary-Auflistung ist schreibgeschützt.

Beispiele

Im folgenden Codebeispiel wird die Änderung einer OrderedDictionary Auflistung veranschaulicht. In diesem Beispiel wird die Item[] Eigenschaft verwendet, um den Wörterbucheintrag mit dem Schlüssel "testKey2"zu ändern. Dieser Code ist Teil eines größeren Codebeispiels, das unter OrderedDictionary" angezeigt werden kann.

// 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

Hinweise

Mit dieser Eigenschaft können Sie mithilfe der folgenden Syntax auf ein bestimmtes Element in der Auflistung zugreifen: myCollection[key]

Sie können auch die Item[] Eigenschaft verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, der in der OrderedDictionary Auflistung nicht vorhanden ist (z myCollection["myNonexistentKey"] = myValue. B. ). Wenn der angegebene Schlüssel jedoch bereits in der OrderedDictionaryEigenschaft vorhanden ist, überschreibt das Festlegen der Item[] Eigenschaft den alten Wert. Im Gegensatz dazu ändert die Add Methode keine vorhandenen Elemente.

Ein Schlüssel kann nicht sein null, aber ein Wert kann sein. Um zwischen diesem zurückgegebenen Wert zu unterscheiden null , da der angegebene Schlüssel nicht gefunden wird und null das zurückgegeben wird, da der Wert des angegebenen Schlüssels nulllautet, verwenden Sie die Contains Methode, um zu ermitteln, ob der Schlüssel im Wert OrderedDictionaryvorhanden ist.