Bagikan melalui

ObjectDataSourceView.ExecuteUpdate Metode

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Melakukan operasi pembaruan dengan memanggil metode yang diidentifikasi oleh UpdateMethod properti dan menggunakan parameter apa pun yang disediakan dalam keyskoleksi , , valuesatau 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

Int32

Jumlah baris yang diperbarui; atau -1, jika nomor tidak diketahui. Untuk informasi selengkapnya, lihat Update().

Pengecualian

NotSupportedException

Properti CanInsert mengembalikan false.

InvalidOperationException

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.

Berlaku untuk

Lihat juga