SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Metode

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.dll

Melakukan operasi penghapusan menggunakan DeleteCommand string SQL, parameter apa pun yang ditentukan dalam DeleteParameters koleksi, dan nilai yang ada dalam koleksi dan oldValues yang ditentukankeys.

protected:
 override int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);

protected override int ExecuteDelete (System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);

override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> int

Protected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer

Parameter

keys

IDictionary

Nilai IDictionary kunci objek atau baris untuk operasi yang ExecuteDelete(IDictionary, IDictionary) akan dihapus.

oldValues

IDictionary

Yang IDictionary berisi nilai baris yang dievaluasi hanya jika ConflictDetection properti diatur ke CompareAllValues nilai .

Mengembalikan

Int32

Nilai yang menunjukkan jumlah baris yang dihapus dari 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 mengakses database.

-atau-

Instans kontrol adalah AccessDataSource kontrol dan akses ditolak ke jalur yang ditentukan untuk DataFile properti .

NotSupportedException

Properti CanDelete adalah false.

-atau-

Jalur relatif waktu desain tidak dipetakan dengan benar oleh perancang sebelum menggunakan instans AccessDataSource kontrol.

Keterangan

Kelas SqlDataSourceView mengimplementasikan metode yang diwariskan ExecuteDelete untuk menghapus data dari database. Pengembang halaman dan penulis kontrol terikat data tidak memanggil ExecuteDelete metode secara langsung; sebagai gantinya, gunakan metode yang diekspos Delete secara publik.

Nilai yang terkandung dalam keys koleksi dievaluasi dan digabungkan dengan nilai apa pun yang dimuat oleh DeleteParameters koleksi. ConflictDetection Jika properti diatur ke CompareAllValues nilai , nilai yang terkandung dalam koleksi diformat oldValues dengan OldValuesParameterFormatString properti dan juga digabungkan.

Sebelum operasi penghapusan dilakukan, OnDeleting metode dipanggil untuk menaikkan Deleting peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai parameter dan melakukan prapemrosebaran sebelum penghapusan.

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

Lihat juga

• Delete(IDictionary, IDictionary)
• DeleteCommand
• DeleteParameters