OrderedDictionary.Item[] Eigenschaft

Definition

Namespace:
System.Collections.Specialized
Assemblys:
System.dll, System.Collections.Specialized.dll
Assemblys:
netstandard.dll, System.Collections.Specialized.dll
Assembly:
System.Collections.Specialized.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Dient zum Abrufen oder Festlegen des angegebenen Werts.

Überlädt

Name Beschreibung
Item[Int32]

Dient zum Abrufen oder Festlegen des Werts am angegebenen Index.
Item[Object]

Dient zum Abrufen oder Festlegen des Werts mit dem angegebenen Schlüssel.

Item[Int32]

Quelle:
OrderedDictionary.cs
Quelle:
OrderedDictionary.cs
Quelle:
OrderedDictionary.cs
Quelle:
OrderedDictionary.cs
Quelle:
OrderedDictionary.cs

Dient zum Abrufen oder Festlegen des Werts am angegebenen Index.

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 0 (null).

-oder-

index ist gleich oder größer als 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 Item[] als default-Eigenschaft, die die gleiche Indizierungsfunktion bereitstellt.

Gilt für:

Item[Object]

Quelle:
OrderedDictionary.cs
Quelle:
OrderedDictionary.cs
Quelle:
OrderedDictionary.cs
Quelle:
OrderedDictionary.cs
Quelle:
OrderedDictionary.cs

Dient zum Abrufen oder Festlegen des Werts mit dem angegebenen Schlüssel.

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 werts, der abgerufen oder festgelegt werden soll.

Eigenschaftswert

Object

Der dem angegebenen Schlüssel zugeordnete Wert. Wenn der angegebene Schlüssel nicht gefunden wird, wird versucht, ihn zurückzuholen null, und der Versuch, ihn festzulegen, ein neues Element mithilfe des angegebenen Schlüssels 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 angezeigt OrderedDictionarywerden 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 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 die Item[] Eigenschaft auch verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, der in der OrderedDictionary Auflistung nicht vorhanden ist (z. B myCollection["myNonexistentKey"] = myValue. ). Wenn der angegebene Schlüssel jedoch bereits im OrderedDictionaryBereich 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 null dem zurückgegebenen Wert zu unterscheiden, da der angegebene Schlüssel nicht gefunden wird und null das zurückgegeben wird, da der Wert des angegebenen Schlüssels lautet null, verwenden Sie die Contains Methode, um zu ermitteln, ob der Schlüssel in der OrderedDictionary.

Gilt für: