Hashtable.Item[Object] Properti

Definisi

Ruang nama:

System.Collections

Rakitan:

System.Runtime.dll

Sumber:

Hashtable.cs

Mendapatkan atau mengatur nilai yang terkait dengan kunci yang ditentukan.

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

Parameter

key

Object

Kunci yang nilainya akan didapatkan atau ditetapkan.

Nilai Properti

Object

Nilai yang terkait dengan kunci yang ditentukan. Jika kunci yang ditentukan tidak ditemukan, mencoba mendapatkannya mengembalikan null, dan mencoba mengaturnya akan membuat elemen baru menggunakan kunci yang ditentukan.

Penerapan

Item[Object]

Pengecualian

ArgumentNullException

keyadalah null.

NotSupportedException

Properti diatur dan Hashtable bersifat baca-saja.

-atau-

Properti diatur, key tidak ada dalam koleksi, dan Hashtable memiliki ukuran tetap.

Keterangan

Properti ini menyediakan kemampuan untuk mengakses elemen tertentu dalam koleksi dengan menggunakan sintaks berikut: myCollection[key].

Anda juga dapat menggunakan Item[] properti untuk menambahkan elemen baru dengan mengatur nilai kunci yang tidak ada di Hashtable; misalnya, myCollection["myNonexistentKey"] = myValue. Namun, jika kunci yang ditentukan sudah ada di Hashtable, pengaturan Item[] properti akan menimpa nilai lama. Sebaliknya, Add metode tidak memodifikasi elemen yang ada.

Kunci tidak boleh null, tetapi nilainya bisa. Untuk membedakan antara null yang dikembalikan karena kunci yang ditentukan tidak ditemukan dan null yang dikembalikan karena nilai kunci yang ditentukan adalah null, gunakan Contains metode atau ContainsKey metode untuk menentukan apakah kunci ada dalam daftar.

Mengambil nilai properti ini adalah O(1) operasi; mengatur properti juga merupakan O(1) operasi.

Bahasa C# menggunakan this kata kunci untuk menentukan pengindeks alih-alih mengimplementasikan Item[] properti . Visual Basic mengimplementasikan Item[] sebagai properti default, yang menyediakan fungsionalitas pengindeksan yang sama.

Lihat juga

• Add(Object, Object)