GridView.RowDeleting Kejadian
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.
Terjadi saat tombol Hapus baris diklik, tetapi sebelum GridView kontrol menghapus baris.
public:
event System::Web::UI::WebControls::GridViewDeleteEventHandler ^ RowDeleting;public event System.Web.UI.WebControls.GridViewDeleteEventHandler RowDeleting;member this.RowDeleting : System.Web.UI.WebControls.GridViewDeleteEventHandler Public Custom Event RowDeleting As GridViewDeleteEventHandler Jenis Acara
Contoh
Contoh berikut menunjukkan cara menggunakan RowDeleting peristiwa untuk membatalkan operasi penghapusan. Halaman berisi GridView kontrol yang menampilkan daftar nama dan alamat pelanggan dari database AdventureWorksLT. Saat pengguna mengklik tautan Hapus untuk baris, handler untuk RowDeleting peristiwa memeriksa nama belakang orang yang ditampilkan di baris yang coba dihapus pengguna. Jika nama belakang adalah "Beaver", operasi penghapusan dibatalkan, dan pesan kesalahan ditampilkan. Untuk nama lain, operasi penghapusan berlanjut dan baris dihapus.
Penanganan aktivitas menggunakan RowIndex properti GridViewDeleteEventArgs objek untuk menemukan baris yang coba dihapus pengguna. Contoh memeriksa konten Rows koleksi. Jika nilai yang ingin Anda bandingkan adalah nilai kunci, Anda dapat memeriksa koleksi sebagai gantinya DataKeys .
Baris dihapus dari tabel CustomerAddress alih-alih tabel Pelanggan untuk menjaga contoh tetap sederhana. GridView Kontrol menunjukkan hasil bergabung dengan tiga tabel: Pelanggan, Alamat, dan CustomerAddress. Saat baris CustomerAddress dihapus, baris yang GridView sesuai akan hilang. Batasan integritas referensial akan membuat kode untuk contoh yang benar-benar menghapus baris dari tabel Pelanggan lebih kompleks.
Untuk informasi tentang cara menyiapkan database AdventureWorksLT, lihat Cara: Menyiapkan Database Sampel AdventureWorksLT untuk pengembangan ASP.NET.
<%@ 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">
void CustomersGridView_RowDeleting
(Object sender, GridViewDeleteEventArgs e)
{
TableCell cell = CustomersGridView.Rows[e.RowIndex].Cells[2];
if (cell.Text == "Beaver")
{
e.Cancel = true;
Message.Text = "You cannot delete customer Beaver.";
}
else
{
Message.Text = "";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>GridView RowDeleting Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>
GridView RowDeleting Example
</h3>
<asp:Label ID="Message" ForeColor="Red" runat="server" />
<br />
<asp:GridView ID="CustomersGridView" runat="server"
DataSourceID="CustomersSqlDataSource"
AutoGenerateColumns="False"
AutoGenerateDeleteButton="True"
OnRowDeleting="CustomersGridView_RowDeleting"
DataKeyNames="CustomerID,AddressID">
<Columns>
<asp:BoundField DataField="FirstName"
HeaderText="FirstName" SortExpression="FirstName" />
<asp:BoundField DataField="LastName" HeaderText="LastName"
SortExpression="LastName" />
<asp:BoundField DataField="City" HeaderText="City"
SortExpression="City" />
<asp:BoundField DataField="StateProvince" HeaderText="State"
SortExpression="StateProvince" />
</Columns>
</asp:GridView>
<asp:SqlDataSource ID="CustomersSqlDataSource" runat="server"
SelectCommand="SELECT SalesLT.CustomerAddress.CustomerID,
SalesLT.CustomerAddress.AddressID,
SalesLT.Customer.FirstName,
SalesLT.Customer.LastName,
SalesLT.Address.City,
SalesLT.Address.StateProvince
FROM SalesLT.Customer
INNER JOIN SalesLT.CustomerAddress
ON SalesLT.Customer.CustomerID =
SalesLT.CustomerAddress.CustomerID
INNER JOIN SalesLT.Address ON SalesLT.CustomerAddress.AddressID =
SalesLT.Address.AddressID"
DeleteCommand="Delete from SalesLT.CustomerAddress where CustomerID =
@CustomerID and AddressID = @AddressID"
ConnectionString="<%$ ConnectionStrings:AdventureWorksLTConnectionString %>">
<DeleteParameters>
<asp:Parameter Name="AddressID" />
<asp:Parameter Name="CustomerID" />
</DeleteParameters>
</asp:SqlDataSource>
</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">
Private Sub CustomersGridView_RowDeleting _
(ByVal sender As [Object], _
ByVal e As GridViewDeleteEventArgs)
Dim cell As TableCell
cell = CustomersGridView.Rows(e.RowIndex).Cells(2)
If cell.Text = "Beaver" Then
e.Cancel = True
Message.Text = "You cannot delete customer Beaver."
Else
Message.Text = ""
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>GridView RowDeleting Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>
GridView RowDeleting Example
</h3>
<asp:Label ID="Message" ForeColor="Red" runat="server" />
<br />
<asp:GridView ID="CustomersGridView" runat="server"
DataSourceID="CustomersSqlDataSource"
AutoGenerateColumns="False"
AutoGenerateDeleteButton="True"
OnRowDeleting="CustomersGridView_RowDeleting"
DataKeyNames="CustomerID,AddressID">
<Columns>
<asp:BoundField DataField="FirstName"
HeaderText="FirstName" SortExpression="FirstName" />
<asp:BoundField DataField="LastName" HeaderText="LastName"
SortExpression="LastName" />
<asp:BoundField DataField="City" HeaderText="City"
SortExpression="City" />
<asp:BoundField DataField="StateProvince" HeaderText="State"
SortExpression="StateProvince" />
</Columns>
</asp:GridView>
<asp:SqlDataSource ID="CustomersSqlDataSource" runat="server"
SelectCommand="SELECT SalesLT.CustomerAddress.CustomerID,
SalesLT.CustomerAddress.AddressID,
SalesLT.Customer.FirstName,
SalesLT.Customer.LastName,
SalesLT.Address.City,
SalesLT.Address.StateProvince
FROM SalesLT.Customer
INNER JOIN SalesLT.CustomerAddress
ON SalesLT.Customer.CustomerID =
SalesLT.CustomerAddress.CustomerID
INNER JOIN SalesLT.Address ON SalesLT.CustomerAddress.AddressID =
SalesLT.Address.AddressID"
DeleteCommand="Delete from SalesLT.CustomerAddress where CustomerID =
@CustomerID and AddressID = @AddressID"
ConnectionString="<%$ ConnectionStrings:AdventureWorksLTConnectionString %>">
<DeleteParameters>
<asp:Parameter Name="AddressID" />
<asp:Parameter Name="CustomerID" />
</DeleteParameters>
</asp:SqlDataSource>
</form>
</body>
</html>
Keterangan
Peristiwa RowDeleting dimunculkan saat tombol Hapus baris diklik, tetapi sebelum GridView kontrol menghapus baris. Ini memungkinkan Anda untuk menyediakan metode penanganan peristiwa yang melakukan rutinitas kustom, seperti membatalkan operasi penghapusan, setiap kali peristiwa ini terjadi.
Objek GridViewDeleteEventArgs diteruskan ke metode penanganan peristiwa, yang memungkinkan Anda menentukan indeks baris saat ini dan untuk menunjukkan bahwa operasi penghapusan harus dibatalkan. Untuk membatalkan operasi penghapusan, atur Cancel properti objek ke GridViewDeleteEventArgstrue. Anda juga dapat memanipulasi Keys koleksi dan Values , jika perlu, sebelum nilai diteruskan ke sumber data.
Untuk informasi selengkapnya tentang cara menangani peristiwa, lihat Menangani dan Menaikkan Peristiwa.
