SortedList.Item[Object] Özellik

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kodlar:

netstandard.dll, 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şkili anahtar.

Özellik Değeri

Object

nesnesindeki keySortedList parametresiyle ilişkili değer, bulunursa key , değilse , null.

Uygulamalar

Item[Object]

Özel durumlar

ArgumentNullException

key, null'e eşittir.

NotSupportedException

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

-veya-

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

OutOfMemoryException

öğesine eklemek SortedListiç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].

Nesnesinde SortedList bulunmayan bir anahtarın değerini ayarlayarak yeni öğeler eklemek için de bu özelliği 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ü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 veya ContainsKey yöntemini kullanarak Contains anahtarın listede mevcut olup olmadığını belirleyin.

öğeleriSortedList, anahtarlar tarafından oluşturulurken SortedList belirtilen belirli IComparer bir uygulamaya veya anahtarların IComparable kendisi tarafından sağlanan uygulamaya 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 değeridir 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 bir O(n) işlemdir veya O(log n) yeni öğe listenin sonuna eklenir. Ekleme yeniden boyutlandırmaya neden oluyorsa, işlem olur O(n).

Ayrıca bkz.

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• Koleksiyonlarda Culture-Insensitive Dize İşlemleri Gerçekleştirme