SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metode

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

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 menggunakan UpdateCommand string SQL, parameter apa pun yang ada dalam UpdateParameters koleksi, dan nilai yang ada dalam koleksi , , valuesdan oldValues yang ditentukankeys.

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 yang akan digunakan dengan UpdateCommand properti untuk melakukan operasi database pembaruan. Jika tidak ada kunci yang terkait dengan kueri atau jika UpdateCommand properti bukan kueri SQL berparameter, lewati null.

values: IDictionary

Nilai IDictionary yang akan digunakan dengan UpdateCommand properti untuk melakukan operasi database pembaruan. Jika tidak ada parameter yang terkait dengan kueri atau jika UpdateCommand bukan kueri SQL berparameter, lewati null.

oldValues: IDictionary

Yang IDictionary mewakili nilai asli dalam database. Jika tidak ada parameter yang terkait dengan kueri atau jika UpdateCommand properti bukan kueri SQL berparameter, lewati null.

Mengembalikan

Int32

Nilai yang menunjukkan jumlah baris yang diperbarui dalam database yang mendasar.

Pengecualian

InvalidOperationException

SqlDataSource tidak dapat membuat koneksi dengan sumber data yang mendasar.

-atau-

Properti ConflictDetection diatur ke CompareAllValues nilai dan tidak ada oldValues parameter yang diteruskan.

HttpException

Pengguna saat ini tidak memiliki izin yang benar untuk mendapatkan akses ke database.

NotSupportedException

Properti CanUpdate adalah false.

Keterangan

Kelas SqlDataSourceView mengimplementasikan metode yang diwariskan ExecuteUpdate untuk memperbarui data dalam database. 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 yang terkandung dalam koleksi diformat oldValues dengan OldValuesParameterFormatString 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 pra-pemrosesan sebelum pembaruan.

Untuk melakukan operasi, SqlDataSourceView menyusun objek menggunakan UpdateCommand teks dan properti terkaitUpdateParameters, lalu menjalankan objek terhadap database yang mendasar DbCommand DbCommand. Setelah operasi selesai, OnUpdated metode dipanggil untuk menaikkan Updated peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai pengembalian dan kode kesalahan apa pun dan untuk melakukan pasca-pemrosesan.

Berlaku untuk

Bagikan melalui