Hashtable.Item[Object] Özellik

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kod:

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 değeridir.

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 Hashtablebir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanabilirsinizItem[]; ö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ü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.

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ü Item[] kullanırthis. Visual Basic, aynı dizin oluşturma işlevini sağlayan varsayılan bir özellik olarak uygular Item[] .

Ayrıca bkz.

• Add(Object, Object)