OrderedDictionary.Item[] Özellik

Tanım

Ad Alanı:

System.Collections.Specialized

Bütünleştirilmiş Kod:

System.Collections.Specialized.dll

Belirtilen değeri alır veya ayarlar.

Aşırı Yüklemeler

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, aynı dizin oluşturma işlevini sağlayan varsayılan bir özellik olarak uygularItem[].

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 (!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ülen ve null belirtilen nullanahtarın değeri olduğundan döndürülen değeri arasında null ayrım yapmak için yöntemini kullanarak Contains anahtarın içinde OrderedDictionarymevcut olup olmadığını belirleyin.