OrderedDictionary.Item[] Vlastnost

Definice

Obor názvů:

System.Collections.Specialized

Sestavení:

System.Collections.Specialized.dll

Získá nebo nastaví zadanou hodnotu.

Přetížení

Item[Int32]	Získá nebo nastaví hodnotu v zadaném indexu.
Item[Object]	Získá nebo nastaví hodnotu se zadaným klíčem.

Item[Int32]

Zdroj:

OrderedDictionary.cs

Získá nebo nastaví hodnotu v zadaném indexu.

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

Parametry

index

Int32

Index hodnoty od nuly, kterou chcete získat nebo nastavit.

Hodnota vlastnosti

Object

Hodnota položky v zadaném indexu.

Implementuje

Item[Int32]

Výjimky

NotSupportedException

Vlastnost se nastavuje a OrderedDictionary kolekce je jen pro čtení.

ArgumentOutOfRangeException

Hodnota index je menší než nula.

-nebo-

index je rovno nebo větší než Count.

Poznámky

Tato vlastnost umožňuje přístup ke konkrétnímu prvku v kolekci pomocí následující syntaxe: myCollection[index].

Jazyk C# používá toto klíčové slovo k definování indexerů místo implementace Item[] vlastnosti . Visual Basic implementuje Item[] jako výchozí vlastnost, která poskytuje stejné funkce indexování.

Item[Object]

Zdroj:

OrderedDictionary.cs

Získá nebo nastaví hodnotu se zadaným klíčem.

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

Parametry

key

Object

Klíč hodnoty, kterou chcete získat nebo nastavit.

Hodnota vlastnosti

Object

Hodnota přidružená k zadanému klíči. Pokud se zadaný klíč nenajde, při pokusu o jeho získání se vrátí nulla při pokusu o jeho nastavení se vytvoří nový prvek pomocí zadaného klíče.

Implementuje

Item[Object]

Výjimky

NotSupportedException

Vlastnost se nastavuje a OrderedDictionary kolekce je jen pro čtení.

Příklady

Následující příklad kódu ukazuje úpravu OrderedDictionary kolekce. V tomto příkladu Item[] se vlastnost používá k úpravě položky slovníku pomocí klíče "testKey2". Tento kód je součástí většího příkladu kódu, který lze zobrazit na adrese 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

Poznámky

Tato vlastnost umožňuje přístup ke konkrétnímu prvku v kolekci pomocí následující syntaxe: myCollection[key].

Vlastnost můžete použít také Item[] k přidání nových prvků nastavením hodnoty klíče, který v kolekci OrderedDictionary neexistuje (například myCollection["myNonexistentKey"] = myValue). Pokud však zadaný klíč již existuje v OrderedDictionary, nastavení Item[] vlastnosti přepíše starou hodnotu. Naproti tomu Add metoda neupravuje existující prvky.

Klíč nemůže být null, ale hodnota může být. Pokud chcete rozlišovat mezi null vrácenou hodnotou, protože zadaný klíč nebyl nalezen a null který se vrátí, protože hodnota zadaného klíče je null, pomocí Contains metody zjistěte, jestli klíč existuje v OrderedDictionary.