SortedList.Item[Object] Properti

Definisi

Ruang nama:

System.Collections

Rakitan:

System.Collections.NonGeneric.dll

Sumber:

SortedList.cs

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

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

Object

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

Penerapan

Item[Object]

Pengecualian

ArgumentNullException

keyadalah null.

NotSupportedException

Properti diatur dan SortedList objek bersifat baca-saja.

-atau-

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

OutOfMemoryException

Memori yang tersedia tidak cukup untuk menambahkan elemen ke SortedList.

InvalidOperationException

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).

Lihat juga

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• Melakukan Operasi String Culture-Insensitive dalam Koleksi