SqlDataSource.Delete 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 penghapusan menggunakan DeleteCommand string SQL dan parameter apa pun yang ada dalam DeleteParameters koleksi.
public:
int Delete();
public int Delete ();
member this.Delete : unit -> int
Public Function Delete () As Integer
Mengembalikan
Nilai yang menunjukkan jumlah baris yang dihapus dari database yang mendasar.
Pengecualian
SqlDataSource tidak dapat membuat koneksi dengan sumber data yang mendasar.
Contoh
Contoh kode berikut menunjukkan cara mengatur DeleteCommand teks untuk menghapus pesanan dari database Northwind. Awalnya, data diambil dari tabel Pesanan dan ditampilkan dalam DropDownList kontrol. Anda harus secara eksplisit mendeklarasikan DeleteParameters properti dan memanggil Delete metode saat menggunakan kontrol terikat data, seperti DropDownList (tidak seperti kontrol lain, seperti GridView dan DetailsView, yang secara otomatis mengisi parameter dan memanggil Delete metode pada kontrol sumber data). Dalam contoh ini, OnClick peristiwa didelegasikan ke penanganan aktivitas privat OnDelete
, yang secara eksplisit memanggil Delete metode SqlDataSource kontrol.
<%@Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void OnDelete(Object sender, EventArgs e) {
SqlDataSource1.Delete();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT OrderID FROM Orders"
DeleteCommand="DELETE FROM [Order Details] WHERE OrderID=@OrderID;DELETE FROM Orders WHERE OrderID=@OrderID;">
<DeleteParameters>
<asp:ControlParameter Name="OrderID" ControlId="DropDownList1" PropertyName="SelectedValue" />
</DeleteParameters>
</asp:SqlDataSource>
<asp:DropDownList
id="DropDownList1"
runat="server"
DataTextField="OrderID"
DataValueField="OrderID"
DataSourceID="SqlDataSource1">
</asp:DropDownList>
<asp:Button
id="Button1"
runat="server"
Text="Delete Order"
OnClick="OnDelete">
</asp:Button>
</form>
</body>
</html>
<%@Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub On_Delete(ByVal sender As Object, ByVal e As EventArgs)
SqlDataSource1.Delete()
End Sub 'On_Delete
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommand="SELECT OrderID FROM Orders"
DeleteCommand="DELETE FROM [Order Details] WHERE OrderID=@OrderID;DELETE FROM Orders WHERE OrderID=@OrderID;">
<DeleteParameters>
<asp:ControlParameter Name="OrderID" ControlId="DropDownList1" PropertyName="SelectedValue" />
</DeleteParameters>
</asp:SqlDataSource>
<asp:DropDownList
id="DropDownList1"
runat="server"
DataTextField="OrderID"
DataValueField="OrderID"
DataSourceID="SqlDataSource1">
</asp:DropDownList>
<asp:Button
id="Button1"
runat="server"
Text="Delete Order"
OnClick="On_Delete">
</asp:Button>
</form>
</body>
</html>
Keterangan
Sebelum operasi penghapusan dilakukan, OnDeleting metode dipanggil untuk menaikkan Deleting peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai parameter dan melakukan praproscesing sebelum operasi penghapusan.
Setelah operasi selesai, metode dipanggil OnDeleted untuk menaikkan Deleted peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai pengembalian dan kode kesalahan dan untuk melakukan pasca-pemrosesan.
Metode Delete ini disediakan untuk akses terprogram ke Delete
metode . Jika kontrol dikaitkan SqlDataSource dengan kontrol terikat data, kontrol terikat data secara otomatis memanggil metode Hapus .
Metode ini Delete mendelegasikan ke Delete metode SqlDataSourceView objek yang terkait dengan SqlDataSource kontrol. Untuk melakukan operasi, SqlDataSourceView membuat objek menggunakan DeleteCommand teks dan nilai terkait DeleteParameters apa pun, lalu menjalankan terhadap database yang DbCommand mendasarDbCommand.