Hashtable.Item[Object] Özellik

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Hashtable.cs

Belirtilen anahtarla 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

Değeri alınacak veya ayarlanacağı 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

ArgumentNullException

key, null'e eşittir.

NotSupportedException

özelliği ayarlanır ve Hashtable salt okunurdur.

-veya-

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

Açıklamalar

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

özelliğini, içinde bulunmayan Item[]bir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanabilirsinizHashtable; örneğin, myCollection["myNonexistentKey"] = myValue. Ancak, belirtilen anahtar içinde Hashtablezaten 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 Contains yöntemini kullanarak ContainsKey anahtarın listede mevcut olup olmadığını belirleyin.

Bu özelliğin değerini almak bir O(1) işlemdir; özelliği ayarlamak da bir O(1) işlemdir.

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

Ayrıca bkz.

• Add(Object, Object)