Bagikan melalui


SortedList.Item[Object] Properti

Definisi

Mendapatkan atau mengatur nilai yang terkait dengan kunci tertentu dalam SortedList objek.

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 terkait dengan nilai untuk mendapatkan atau mengatur.

Nilai Properti

Nilai yang key terkait dengan parameter dalam SortedList objek, jika key ditemukan; jika tidak, null.

Penerapan

Pengecualian

keyadalah null.

Properti diatur dan SortedList objek bersifat baca-saja.

-atau-

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

Memori yang tersedia tidak cukup untuk menambahkan elemen ke SortedList.

Pembanding memberikan pengecualian.

Keterangan

Anda dapat menggunakan Item[] properti untuk mengakses elemen tertentu dalam koleksi dengan menentukan sintaks berikut: myCollection[key].

Anda juga dapat menggunakan properti ini untuk menambahkan elemen baru dengan mengatur nilai kunci yang tidak ada di SortedList objek (misalnya, myCollection["myNonexistentKey"] = myValue). Namun, jika kunci yang ditentukan sudah ada di SortedList, 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.

Elemen diurutkan SortedList berdasarkan kunci baik sesuai dengan implementasi tertentu IComparer yang ditentukan ketika SortedList dibuat atau sesuai dengan IComparable implementasi yang disediakan oleh kunci itu sendiri.

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

Mengambil nilai properti ini adalah O(log n) operasi, di mana n adalah Count. Mengatur properti adalah O(log n) operasi jika kunci sudah ada di SortedList. Jika kunci tidak ada dalam daftar, mengatur properti adalah operasi untuk data yang O(n) tidak diurai, atau O(log n) jika elemen baru ditambahkan di akhir daftar. Jika penyisipan menyebabkan pengurangan ukuran, operasinya adalah O(n).

Berlaku untuk

Lihat juga