OrderedDictionary.Item[] Özellik

Tanım

Ad Alanı:

System.Collections.Specialized

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Collections.Specialized.dll

Belirtilen değeri alır veya ayarlar.

Aşırı Yüklemeler

Name	Description
Item[Int32]	Belirtilen dizindeki değeri alır veya ayarlar.
Item[Object]	Belirtilen anahtarla değeri alır veya ayarlar.

Item[Int32]

Kaynak:

OrderedDictionary.cs

Belirtilen dizindeki değeri alır veya ayarlar.

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

Parametreler

index

Int32

Alınacak veya ayarlanacağı değerin sıfır tabanlı dizini.

Özellik Değeri

Object

Belirtilen dizindeki öğenin değeri.

Uygulamalar

Item[Int32]

Özel durumlar

NotSupportedException

özelliği ayarlanıyor ve OrderedDictionary koleksiyon salt okunur.

ArgumentOutOfRangeException

index, sıfırdan küçüktür.

-veya-

index eşittir veya değerinden Countbüyüktür.

Açıklamalar

Bu özellik, aşağıdaki söz dizimini kullanarak koleksiyondaki belirli bir öğeye erişmenizi sağlar: myCollection[index].

C# dili , özelliğini uygulamak Item[] yerine dizin oluşturucuları tanımlamak için bu anahtar sözcüğü kullanır. Visual Basic Item[] aynı dizin oluşturma işlevini sağlayan default özelliği olarak uygular.

Item[Object]

Kaynak:

OrderedDictionary.cs

Belirtilen anahtarla değeri alır veya ayarlar.

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

Parametreler

key

Object

Alınacak veya ayarlanacağı değerin anahtarı.

Özellik Değeri

Object

Belirtilen anahtarla ilişkili değer. Belirtilen anahtar bulunamazsa, almaya çalışmak döndürür nullve ayarlamaya çalışmak, belirtilen anahtarı kullanarak yeni bir öğe oluşturur.

Uygulamalar

Item[Object]

Özel durumlar

NotSupportedException

özelliği ayarlanıyor ve OrderedDictionary koleksiyon salt okunur.

Örnekler

Aşağıdaki kod örneği bir OrderedDictionary koleksiyonun değiştirilmesini gösterir. Bu örnekte özelliği, Item[] sözlük girdisini anahtarıyla "testKey2"değiştirmek için kullanılır. Bu kod, adresinde OrderedDictionarygörüntülenebilen daha büyük bir kod örneğinin parçasıdır.

// 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

Açıklamalar

Bu özellik, aşağıdaki söz dizimini kullanarak koleksiyondaki belirli bir öğeye erişmenizi sağlar: myCollection[key].

Özelliğini, koleksiyonda Item[]OrderedDictionary bulunmayan bir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanabilirsiniz (örneğin, myCollection["myNonexistentKey"] = myValue). Ancak, belirtilen anahtar içinde OrderedDictionaryzaten varsa, özelliğini ayarlamak Item[] eski değerin üzerine yazar. Buna karşılık, Add yöntemi mevcut öğeleri değiştirmez.

Anahtar olamaz null, ancak bir değer olabilir. Belirtilen anahtar bulunamadığından döndürülür ve null belirtilen nullanahtarın değeri olduğu için döndürülür arasında null ayrım yapmak için yöntemini kullanarak Contains anahtarın içinde OrderedDictionaryvar olup olmadığını belirleyin.