OrderedDictionary.Item[] Eigenschaft

  • Referenz

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]

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

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 die Schlüsselwort (keyword), um die Indexer zu definieren, anstatt die Item[] -Eigenschaft zu implementieren. Visual Basic implementiert Item[] als Standardeigenschaft, die die gleiche Indizierungsfunktion bereitstellt.

Gilt für:

Item[Object]

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

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 OrderedDictionaryangezeigt 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 die Item[] -Eigenschaft auch verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, myCollection["myNonexistentKey"] = myValueder in der OrderedDictionary Auflistung nicht vorhanden ist (z. B. ). Wenn der angegebene Schlüssel jedoch bereits in vorhanden ist, überschreibt die OrderedDictionaryItem[] -Eigenschaft den alten Wert. Im Gegensatz dazu ändert die Add Methode vorhandene Elemente nicht.

Ein Schlüssel kann nicht sein null, aber ein Wert kann sein. Um zu null unterscheiden, dass zurückgegeben wird, weil der angegebene Schlüssel nicht gefunden und null zurückgegeben wird, weil der Wert des angegebenen Schlüssels ist, verwenden Sie die Contains -Methode, um zu bestimmen, ob der Schlüssel in OrderedDictionaryvorhanden istnull.

Gilt für: