閱讀英文版本

分享方式：

GridViewDeleteEventArgs 類別

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

提供 RowDeleting 事件的資料。

C# 
public class GridViewDeleteEventArgs : System.ComponentModel.CancelEventArgs
繼承
Object
EventArgs
CancelEventArgs
GridViewDeleteEventArgs

範例

下列範例示範如何使用 GridViewDeleteEventArgs 傳遞至事件處理常式的物件。 如果使用者嘗試從 控制項移除最後一 GridView 筆記錄，程式碼就會取消刪除作業。

ASP.NET (C#) 

<%@ 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>

備註

GridView按一下 [刪除] 按鈕時，控制項會引發 RowDeleting 事件，但在控制項刪除記錄之前 GridView 。 ([刪除] 按鈕是屬性設定為 「Delete」 的按鈕控制項 CommandName 。) 每當發生此事件時，您可以執行自訂常式，例如取消刪除作業。

GridViewDeleteEventArgs物件會傳遞至事件處理常式。 這可讓您判斷要刪除的資料列索引，以及取消刪除作業。 若要取消刪除作業，請將 Cancel 物件的 屬性 GridViewDeleteEventArgs 設定為 true 。 您也可以在值傳遞至資料來源之前操作 Keys 和 Values 集合。

如需如何處理事件的詳細資訊，請參閱 處理和引發事件。

如需 實例 GridViewDeleteEventArgs 的初始屬性值清單，請參閱 建 GridViewDeleteEventArgs 構函式。

建構函式

GridViewDeleteEventArgs(Int32)

初始化 GridViewDeleteEventArgs 類別的新執行個體。

屬性

Cancel

取得或設定值，這個值表示是否應該取消事件。

(繼承來源 CancelEventArgs)
Keys

取得表示要刪除之主索引鍵的欄位名稱/值組的字典。
RowIndex

取得要刪除之資料列的索引。
Values

取得要刪除之資料列的非索引鍵欄位名稱/值組的字典。

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

產品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另請參閱