ListViewInsertEventArgs.Values 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 nilai untuk rekaman yang akan disisipkan.
public:
property System::Collections::Specialized::IOrderedDictionary ^ Values { System::Collections::Specialized::IOrderedDictionary ^ get(); };
public System.Collections.Specialized.IOrderedDictionary Values { get; }
member this.Values : System.Collections.Specialized.IOrderedDictionary
Public ReadOnly Property Values As IOrderedDictionary
Nilai Properti
Nilai untuk rekaman yang akan disisipkan.
Contoh
Contoh berikut menunjukkan cara melakukan iterasi melalui Values koleksi. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk ListViewInsertEventArgs kelas .
void ContactsListView_ItemInserting(Object sender, ListViewInsertEventArgs e)
{
// Iterate through the values to verify if they are not empty.
foreach (DictionaryEntry de in e.Values)
{
if (de.Value == null)
{
Message.Text = "Cannot insert an empty value.";
e.Cancel = true;
}
}
}
Sub ContactsListView_ItemInserting(ByVal sender As Object, _
ByVal e As ListViewInsertEventArgs)
' Iterate through the values to verify if they are not empty.
For Each de As DictionaryEntry In e.Values
If de.Value Is Nothing Then
Message.Text = "Cannot insert an empty value."
e.Cancel = True
End If
Next
End Sub
Keterangan
Values Gunakan properti untuk mengakses nilai bidang untuk disisipkan rekaman. Misalnya, Anda dapat memvalidasi atau mengodekan HTML nilai rekaman sebelum disisipkan di sumber data.
Properti Values mengembalikan OrderedDictionary objek yang mengimplementasikan IOrderedDictionary antarmuka. Objek OrderedDictionary berisi DictionaryEntry objek yang mewakili bidang rekaman. Untuk mengakses nama bidang, gunakan Keys properti OrderedDictionary objek . Untuk mengakses nilai bidang, gunakan Values properti .
Catatan
Sebagai pintasan, Anda dapat menggunakan pengindeks OrderedDictionary objek untuk mengakses nilai bidang secara langsung. Keuntungan menggunakan pengindeks adalah mengembalikan nilai bidang secara langsung. Kontrol sumber data yang mengandalkan urutan bidang (seperti AccessDataSource) dapat mengakses nilai bidang hanya berdasarkan indeks.