Bagikan melalui


Hashtable.Item[Object] Properti

Definisi

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

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

Pengecualian

keyadalah null.

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.

Berlaku untuk

Lihat juga