GridView.AutoGenerateDeleteButton 屬性

  • 參考

定義

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

取得或設定值，指出是否會將具有每個資料列之 [刪除] 按鈕的 CommandField 欄位資料行自動加入至 GridView 控制項。

public:
 virtual property bool AutoGenerateDeleteButton { bool get(); void set(bool value); };
public virtual bool AutoGenerateDeleteButton { get; set; }
member this.AutoGenerateDeleteButton : bool with get, set
Public Overridable Property AutoGenerateDeleteButton As Boolean

屬性值

Boolean

true 表示自動加入具有每個資料列之 [刪除] 按鈕的 CommandField 欄位資料行，否則為 false。 預設為 false。

範例

下列範例示範如何使用 AutoGenerateDeleteButton 屬性來啟用控制項的 GridView 自動刪除功能。

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

備註

當支援刪除的資料來源控制項系結至 GridView 控制項時， GridView 控制項可以利用資料來源控制項的功能，並提供自動刪除功能。

注意

若要讓資料來源控制項刪除資料，它必須設定為刪除資料。 若要設定資料來源控制項來刪除記錄，請參閱特定資料來源控制項的檔。

AutoGenerateDeleteButton當 屬性設定為 true 時，就會自動將 GridView 每個資料列的 [刪除] 按鈕) 物件所代表 CommandField 的資料行 (。 按一下資料列的 [刪除] 按鈕，會永久移除資料來源中的該記錄。

注意

您也必須設定 DataKeyNames 屬性，以識別資料來源的索引鍵欄位，以便自動刪除功能能夠運作。

控制項 GridView 提供數個事件，您可以在刪除資料列時用來執行自訂動作。 下表列出可用的事件。

事件 描述
RowDeleted 發生于按一下資料列的 [刪除] 按鈕時，但在控制項從資料來源中刪除記錄之後 GridView 。 此事件通常用來檢查刪除作業的結果。
RowDeleting 發生于按一下資料列的 [刪除] 按鈕時，但在控制項從資料來源中刪除記錄之前 GridView 。 此事件通常用來取消刪除作業。

適用於

另請參閱