Hashtable.Item[Object] Özellik

Tanım

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; }
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

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

Özel durumlar

key, null değeridir.

ö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[] .

Şunlara uygulanır

Ayrıca bkz.