OrderedDictionary.Item[] Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nilai yang ditentukan.
Overload
Item[Int32] |
Mendapatkan atau mengatur nilai pada indeks yang ditentukan. |
Item[Object] |
Mendapatkan atau mengatur nilai dengan kunci yang ditentukan. |
Item[Int32]
- Sumber:
- OrderedDictionary.cs
- Sumber:
- OrderedDictionary.cs
- Sumber:
- OrderedDictionary.cs
Mendapatkan atau mengatur nilai pada indeks yang ditentukan.
public:
property System::Object ^ default[int] { System::Object ^ get(int index); void set(int index, System::Object ^ value); };
public object this[int index] { get; set; }
public object? this[int index] { get; set; }
member this.Item(int) : obj with get, set
Default Public Property Item(index As Integer) As Object
Parameter
- index
- Int32
Indeks berbasis nol dari nilai yang akan didapatkan atau diatur.
Nilai Properti
Nilai item pada indeks yang ditentukan.
Penerapan
Pengecualian
Properti sedang diatur dan OrderedDictionary koleksi bersifat baca-saja.
Keterangan
Properti ini memungkinkan Anda mengakses elemen tertentu dalam koleksi dengan menggunakan sintaks berikut: myCollection[index]
.
Bahasa C# menggunakan kata kunci ini untuk menentukan pengindeks alih-alih mengimplementasikan Item[] properti . Visual Basic mengimplementasikan Item[] sebagai properti default, yang menyediakan fungsionalitas pengindeksan yang sama.
Berlaku untuk
Item[Object]
- Sumber:
- OrderedDictionary.cs
- Sumber:
- OrderedDictionary.cs
- Sumber:
- OrderedDictionary.cs
Mendapatkan atau mengatur nilai dengan kunci yang ditentukan.
public:
property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };
public object this[object key] { get; set; }
public object? this[object key] { get; set; }
member this.Item(obj) : obj with get, set
Default Public Property Item(key As Object) As Object
Parameter
- key
- Object
Kunci nilai yang akan didapatkan atau diatur.
Nilai Properti
Nilai yang terkait dengan kunci yang ditentukan. Jika kunci yang ditentukan tidak ditemukan, mencoba mengembalikannya null
, dan mencoba mengaturnya akan membuat elemen baru menggunakan kunci yang ditentukan.
Penerapan
Pengecualian
Properti sedang diatur dan OrderedDictionary koleksi bersifat baca-saja.
Contoh
Contoh kode berikut menunjukkan modifikasi OrderedDictionary koleksi. Dalam contoh ini, Item[] properti digunakan untuk memodifikasi entri kamus dengan kunci "testKey2"
. Kode ini adalah bagian dari contoh kode yang lebih besar yang dapat dilihat di OrderedDictionary.
// Modifying the OrderedDictionary
if (!myOrderedDictionary->IsReadOnly)
{
// Insert a new key to the beginning of the OrderedDictionary
myOrderedDictionary->Insert(0, "insertedKey1", "insertedValue1");
// Modify the value of the entry with the key "testKey2"
myOrderedDictionary["testKey2"] = "modifiedValue";
// Remove the last entry from the OrderedDictionary: "testKey3"
myOrderedDictionary->RemoveAt(myOrderedDictionary->Count - 1);
// Remove the "keyToDelete" entry, if it exists
if (myOrderedDictionary->Contains("keyToDelete"))
{
myOrderedDictionary->Remove("keyToDelete");
}
}
// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
// Insert a new key to the beginning of the OrderedDictionary
myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");
// Modify the value of the entry with the key "testKey2"
myOrderedDictionary["testKey2"] = "modifiedValue";
// Remove the last entry from the OrderedDictionary: "testKey3"
myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);
// Remove the "keyToDelete" entry, if it exists
if (myOrderedDictionary.Contains("keyToDelete"))
{
myOrderedDictionary.Remove("keyToDelete");
}
}
' Modifying the OrderedDictionary
If Not myOrderedDictionary.IsReadOnly Then
' Insert a new key to the beginning of the OrderedDictionary
myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1")
' Modify the value of the entry with the key "testKey2"
myOrderedDictionary("testKey2") = "modifiedValue"
' Remove the last entry from the OrderedDictionary: "testKey3"
myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1)
' Remove the "keyToDelete" entry, if it exists
If (myOrderedDictionary.Contains("keyToDelete")) Then
myOrderedDictionary.Remove("keyToDelete")
End If
End If
Keterangan
Properti ini memungkinkan Anda 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 dalam OrderedDictionary koleksi (misalnya, myCollection["myNonexistentKey"] = myValue
). Namun, jika kunci yang ditentukan sudah ada di OrderedDictionary, 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 untuk menentukan apakah kunci ada di OrderedDictionary.