ObjectDataSourceView.ExecuteUpdate Metode
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.
Melakukan operasi pembaruan dengan memanggil metode yang diidentifikasi oleh UpdateMethod properti dan menggunakan parameter apa pun yang disediakan dalam keys
koleksi , , values
atau oldValues
.
protected:
override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer
Parameter
- keys
- IDictionary
Kunci IDictionary primer untuk digunakan dengan UpdateMethod properti untuk melakukan operasi database pembaruan. Jika tidak ada kunci yang terkait dengan metode , teruskan null
.
- values
- IDictionary
Nilai IDictionary yang akan digunakan dengan UpdateMethod untuk melakukan operasi database pembaruan. Jika tidak ada parameter yang terkait dengan metode , lewati null
.
- oldValues
- IDictionary
IDictionary yang mewakili nilai asli di penyimpanan data yang mendasar. Jika tidak ada parameter yang terkait dengan kueri, lewati null
.
Mengembalikan
Jumlah baris yang diperbarui; atau -1, jika nomor tidak diketahui. Untuk informasi selengkapnya, lihat Update().
Pengecualian
Properti CanInsert mengembalikan false
.
oldValues
adalah null
atau kosong dan ConflictDetection diatur ke CompareAllValues.
Keterangan
Kelas ObjectDataSourceView mengimplementasikan metode yang diwariskan ExecuteUpdate untuk memperbarui data menggunakan objek bisnis. Pengembang halaman dan penulis kontrol terikat data tidak memanggil ExecuteUpdate metode secara langsung; sebagai gantinya, gunakan metode yang diekspos Update secara publik.
Nilai yang terkandung dalam keys
koleksi dan values
dievaluasi dan digabungkan dengan nilai apa pun yang dimuat oleh UpdateParameters koleksi.
ConflictDetection Jika properti diatur ke CompareAllValues nilai , nilai yang terkandung dalam koleksi diformat oldValues
dengan OldValuesParameterFormatString properti dan juga digabungkan.
Sebelum operasi pembaruan dilakukan, OnUpdating metode dipanggil untuk menaikkan Updating peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai parameter dan melakukan praprossesi sebelum pembaruan. Untuk melakukan operasi pembaruan, ObjectDataSourceView menggunakan pantulan untuk memanggil metode yang diidentifikasi oleh UpdateMethod properti dan parameter terkait dalam keys
koleksi, lalu menjalankannya. Setelah operasi selesai, OnUpdated metode dipanggil untuk menaikkan Updated peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai pengembalian, kode kesalahan, dan melakukan pasca-pemrosesan.
Untuk informasi selengkapnya tentang mengembalikan jumlah baris yang diperbarui, lihat Update.