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时，将自动将每个数据行的“删除”按钮) 对象表示CommandField的列 (添加到GridView控件。 单击行的“删除”按钮可永久从数据源中删除该记录。

备注

还必须设置属性 DataKeyNames 以标识数据源的关键字段或字段，以便自动删除功能正常工作。

该 GridView 控件提供了多个事件，可用于在删除行时执行自定义操作。 下表列出了可用的事件。

事件 说明
RowDeleted 单击行的“删除”按钮时发生，但在控件从数据源中删除记录之后 GridView 发生。 此事件通常用于检查删除操作的结果。
RowDeleting 单击行的“删除”按钮，但在控件从数据源中删除记录之前 GridView 发生。 此事件通常用于取消删除操作。

适用于

另请参阅