GridView.RowDeleting 事件
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
按一下資料列的 [刪除] 按鈕時發生 (但在 GridView 控制項刪除資料列之前)。
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 事件類型
範例
下列範例示範如何使用 RowDeleting 事件來取消刪除作業。 頁面包含 GridView 控制項，顯示 AdventureWorksLT 資料庫中的客戶名稱和地址清單。 當使用者按一下資料列的 [刪除] 連結時，事件的處理常式 RowDeleting 會檢查使用者嘗試刪除之資料列中所顯示人員的姓氏。 如果姓氏是 「Beaver」，則會取消刪除作業，並顯示錯誤訊息。 針對任何其他名稱，刪除作業會繼續進行，並刪除資料列。
事件處理常式會使用 RowIndex 物件的 屬性 GridViewDeleteEventArgs 來尋找使用者嘗試刪除的資料列。 此範例會檢查集合的內容 Rows 。 如果您想要比較的值是索引鍵值，您可以改為檢查 DataKeys 集合。
資料列會從 CustomerAddress 資料表中刪除，而不是 Customer 資料表，以便讓範例保持簡單。 控制項 GridView 會顯示聯結三個數據表的結果：Customer、Address 和 CustomerAddress。 刪除 CustomerAddress 資料列時，對應的 GridView 資料列就會消失。 參考完整性條件約束會使程式碼成為實際從 Customer 資料表中刪除資料列的範例。
如需如何設定 AdventureWorksLT 資料庫的資訊，請參閱 如何：設定 AdventureWorksLT 範例資料庫以進行 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>
備註
RowDeleting按一下資料列的 [刪除] 按鈕，但在控制項刪除資料列之前 GridView ，就會引發 事件。 這可讓您提供事件處理方法，以執行自訂常式，例如每當發生此事件時取消刪除作業。
GridViewDeleteEventArgs物件會傳遞至事件處理方法，可讓您判斷目前資料列的索引，並指出應該取消刪除作業。 若要取消刪除作業，請將 Cancel 物件的 屬性 GridViewDeleteEventArgs 設定為 true 。 您也可以在值傳遞至資料來源之前，視需要操作 Keys 和 Values 集合。
如需如何處理事件的詳細資訊，請參閱 處理和引發事件。
