Język

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

Definicja

Przestrzeń nazw:
System.Collections.Specialized
Zestawy:
System.dll, System.Collections.Specialized.dll
Zestawy:
netstandard.dll, System.Collections.Specialized.dll
Zestaw:
System.Collections.Specialized.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll

Pobiera lub ustawia określoną wartość.

Przeciążenia

Nazwa Opis
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
Źródło:
OrderedDictionary.cs
Źródło:
OrderedDictionary.cs
Źródło:
OrderedDictionary.cs
Ź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; }
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. Visual Basic implementuje właściwość Item[] jako właściwość default która zapewnia tę samą funkcję indeksowania.

Dotyczy

Item[Object]

Źródło:
OrderedDictionary.cs
Źródło:
OrderedDictionary.cs
Źródło:
OrderedDictionary.cs
Źródło:
OrderedDictionary.cs
Ź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; }
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 spróbuj ustawić, aby utworzyć 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 pokazuje 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 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ść. Add Natomiast metoda nie modyfikuje istniejących elementów.

Kluczem nie może być null, ale może być wartość. Aby odróżnić null zwracany klucz, ponieważ nie można odnaleźć określonego klucza i null jest zwracany, ponieważ wartość określonego klucza to null, użyj Contains metody , aby określić, czy klucz istnieje w OrderedDictionaryobiekcie .

Dotyczy