OrderedDictionary.Item[] Właściwość

Definicja

Przestrzeń nazw:

System.Collections.Specialized

Zestaw:

System.Collections.Specialized.dll

Pobiera lub ustawia określoną wartość.

Przeciążenia

Item[Int32]	Pobiera lub ustawia wartość w określonym indeksie.
Item[Object]	Pobiera lub ustawia wartość za pomocą określonego klucza.

Item[Int32]

Źródło:

OrderedDictionary.cs

Pobiera lub ustawia wartość w określonym indeksie.

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

Indeks zerowy wartości do pobrania lub ustawienia.

Wartość właściwości

Object

Wartość elementu w określonym indeksie.

Implementuje

Item[Int32]

Wyjątki

NotSupportedException

Właściwość jest ustawiana, a OrderedDictionary kolekcja jest tylko do odczytu.

ArgumentOutOfRangeException

Parametr index ma wartość niższą niż zero.

-lub-

index jest równe lub większe niż Count.

Uwagi

Ta właściwość umożliwia dostęp do określonego elementu w kolekcji przy użyciu następującej składni: myCollection[index].

Język C# używa tego słowa kluczowego do zdefiniowania indeksatorów zamiast implementowania Item[] właściwości . Język Visual Basic implementuje Item[] jako właściwość domyślną, która zapewnia tę samą funkcję indeksowania.

Item[Object]

Źródło:

OrderedDictionary.cs

Pobiera lub ustawia wartość za pomocą określonego klucza.

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

Klucz wartości do pobrania lub ustawienia.

Wartość właściwości

Object

Wartość skojarzona z określonym kluczem. Jeśli określony klucz nie zostanie znaleziony, próba pobrania go zwróci nullwartość i próba ustawienia tworzy nowy element przy użyciu określonego klucza.

Implementuje

Item[Object]

Wyjątki

NotSupportedException

Właściwość jest ustawiana, a OrderedDictionary kolekcja jest tylko do odczytu.

Przykłady

Poniższy przykład kodu przedstawia modyfikację OrderedDictionary kolekcji. W tym przykładzie Item[] właściwość jest używana do modyfikowania wpisu słownika przy użyciu klucza "testKey2". Ten kod jest częścią większego przykładu kodu, który można wyświetlić pod adresem 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

Uwagi

Ta właściwość umożliwia dostęp do określonego elementu w kolekcji przy użyciu następującej składni: myCollection[key].

Możesz również użyć Item[] właściwości , aby dodać nowe elementy, ustawiając wartość klucza, który nie istnieje w OrderedDictionary kolekcji (na przykład myCollection["myNonexistentKey"] = myValue). Jeśli jednak określony klucz już istnieje w OrderedDictionaryobiekcie , ustawienie Item[] właściwości zastępuje starą wartość. Z kolei Add metoda nie modyfikuje istniejących elementów.

Klucz nie może być nullwartością , ale może to być wartość. Aby odróżnić null ten element jest zwracany, ponieważ określony klucz nie został znaleziony i null jest zwracany, ponieważ wartość określonego klucza to null, użyj Contains metody , aby określić, czy klucz istnieje w OrderedDictionaryobiekcie .