SortedList.Item[Object] Özellik

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kod:

System.Collections.NonGeneric.dll

Kaynak:

SortedList.cs

Nesnedeki belirli bir anahtarla SortedList ilişkili değeri alır veya ayarlar.

public:
 virtual property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };

public virtual object? this[object key] { get; set; }

member this.Item(obj) : obj with get, set

Default Public Overridable Property Item(key As Object) As Object

Parametreler

key

Object

Alınacak veya ayarlanacağı değerle ilişkilendirilmiş anahtar.

Özellik Değeri

Object

nesnesindeki keySortedList parametresiyle ilişkilendirilmiş değer( bulunursa key ; değilse , null.

Uygulamalar

Item[Object]

Özel durumlar

ArgumentNullException

key, null değeridir.

NotSupportedException

özelliği ayarlanır ve SortedList nesne salt okunur olur.

-veya-

özelliği ayarlanır, key koleksiyonda yoktur ve sabit bir boyuta SortedList sahiptir.

OutOfMemoryException

öğesine öğesini SortedListeklemek için yeterli kullanılabilir bellek yok.

InvalidOperationException

Karşılaştırıcı bir özel durum oluşturur.

Açıklamalar

Aşağıdaki söz dizimini Item[] belirterek bir koleksiyondaki belirli bir öğeye erişmek için özelliğini kullanabilirsiniz: myCollection[key].

Bu özelliği, nesnede SortedList bulunmayan bir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanabilirsiniz (örneğin, myCollection["myNonexistentKey"] = myValue). Ancak, belirtilen anahtar içinde SortedListzaten 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 veya ContainsKey yöntemini kullanarak Contains anahtarın listede var olup olmadığını belirleyin.

öğesinin SortedList öğeleri, oluşturulurken belirtilen belirli IComparer bir uygulamaya göre veya anahtarların SortedListIComparable kendisi tarafından sağlanan uygulamaya göre anahtarlara göre sıralanır.

C# dili, özelliğini uygulamak yerine dizin oluşturucuları tanımlamak için anahtar sözcüğünü Keys kullanırthis. Visual Basic, aynı dizin oluşturma işlevini sağlayan varsayılan bir özellik olarak uygular Item[] .

Bu özelliğin değerini almak bir O(log n) işlemdir ve burada n da şeklindedir Count. anahtarı zaten içindeyse SortedListözelliğini ayarlamak bir O(log n) işlemdir. Anahtar listede değilse, özelliği ayarlamak sıralanmamış veriler için veya O(log n) listenin sonuna yeni öğe eklenip eklenmediğine yönelik bir O(n) işlemdir. Ekleme yeniden boyutlandırmaya neden olursa, işlem olur O(n).

Ayrıca bkz.

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• Koleksiyonlarda Kültüre Duyarsız Dize İşlemlerini Gerçekleştirme