OrderedDictionary.Item[Object] OrderedDictionary.Item[Object] OrderedDictionary.Item[Object] OrderedDictionary.Item[Object] Property

Definition

Überlädt

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft den Wert am angegebenen Index ab oder legt diesen fest.Gets or sets the value at the specified index.

Item[Object] Item[Object] Item[Object] Item[Object]

Ruft den Wert mit dem angegebenen Schlüssel ab oder legt diesen fest.Gets or sets the value with the specified key.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft den Wert am angegebenen Index ab oder legt diesen fest.Gets or sets the value at the specified 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; }
member this.Item(int) : obj with get, set
Default Public Property Item(index As Integer) As Object

Parameter

index
Int32 Int32 Int32 Int32

Der nullbasierte Index des Werts, der abgerufen oder festgelegt werden soll.The zero-based index of the value to get or set.

Eigenschaftswert

Der Wert des Elements am angegebenen Index.The value of the item at the specified index.

Implementiert

Ausnahmen

Die Eigenschaft wird festgelegt, und die OrderedDictionary-Auflistung ist schreibgeschützt.The property is being set and the OrderedDictionary collection is read-only.

index ist kleiner als Null.index is less than zero.

- oder --or- index ist größer oder gleich Count.index is equal to or greater than Count.

Hinweise

Mit dieser Eigenschaft können Sie auf ein bestimmtes Element in der Auflistung zugreifen, indem Sie die folgende myCollection[index]Syntax verwenden:.This property allows you to access a specific element in the collection by using the following syntax: myCollection[index].

Die C# Sprache verwendet das this -Schlüsselwort, um die Indexer zu definieren, Item[Object] statt die-Eigenschaft zu implementieren.The C# language uses the this keyword to define the indexers instead of implementing the Item[Object] property. Visual Basic implementiert Item[Object] als Standard Eigenschaft, die die gleiche Indizierungs Funktionalität bereitstellt.Visual Basic implements Item[Object] as a default property, which provides the same indexing functionality.

Item[Object] Item[Object] Item[Object] Item[Object]

Ruft den Wert mit dem angegebenen Schlüssel ab oder legt diesen fest.Gets or sets the value with the specified key.

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

Parameter

key
Object Object Object Object

Der Schlüssel des abzurufenden oder festzulegenden Werts.The key of the value to get or set.

Eigenschaftswert

Der dem angegebenen Schlüssel zugeordnete Wert.The value associated with the specified key. 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.If the specified key is not found, attempting to get it returns null, and attempting to set it creates a new element using the specified key.

Implementiert

Ausnahmen

Die Eigenschaft wird festgelegt, und die OrderedDictionary-Auflistung ist schreibgeschützt.The property is being set and the OrderedDictionary collection is read-only.

Beispiele

Im folgenden Codebeispiel wird die Änderung einer OrderedDictionary -Auflistung veranschaulicht.The following code example demonstrates the modification of an OrderedDictionary collection. In diesem Beispiel Item[Object] wird die-Eigenschaft verwendet, um den Wörterbucheintrag mit dem "testKey2"Schlüssel zu ändern.In this example, the Item[Object] property is used to modify the dictionary entry with the key "testKey2". Dieser Code ist Teil eines größeren Code Beispiels, das unter OrderedDictionaryangezeigt werden kann.This code is part of a larger code example that can be viewed at 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 (!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 auf ein bestimmtes Element in der Auflistung zugreifen, indem Sie die folgende myCollection[key]Syntax verwenden:.This property allows you to access a specific element in the collection by using the following syntax: myCollection[key].

Sie können auch die Item[Object] -Eigenschaft verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, der in der OrderedDictionary Auflistung nicht vorhanden myCollection["myNonexistentKey"] = myValueist (z. b.).You can also use the Item[Object] property to add new elements by setting the value of a key that does not exist in the OrderedDictionary collection (for example, myCollection["myNonexistentKey"] = myValue). Wenn jedoch der angegebene Schlüssel bereits in OrderedDictionaryvorhanden ist, wird durch das Festlegen der Item[Object] -Eigenschaft der alte Wert überschrieben.However, if the specified key already exists in the OrderedDictionary, setting the Item[Object] property overwrites the old value. Im Gegensatz dazu ändert Add die-Methode keine vorhandenen Elemente.In contrast, the Add method does not modify existing elements.

Ein Schlüssel kann nicht nullsein, aber ein Wert kann sein.A key cannot be null, but a value can be. Um zu unter null scheiden, ob der angegebene Schlüssel nicht gefunden wurde und null zurückgegeben wird, da der Wert des angegebenen Schlüssels ist null, verwenden Sie die Contains -Methode, um zu bestimmen, ob der Schlüssel im OrderedDictionary.To distinguish between null that is returned because the specified key is not found and null that is returned because the value of the specified key is null, use the Contains method to determine if the key exists in the OrderedDictionary.

Gilt für: