GridView.AutoGenerateDeleteButton 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示每个数据行都带有“删除”按钮的 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
属性值
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 发生。 此事件通常用于取消删除操作。 |