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
時,就會自動將 GridView 每個資料列的 [刪除] 按鈕) 物件所代表 CommandField 的資料行 (。 按一下資料列的 [刪除] 按鈕,會永久移除資料來源中的該記錄。
注意
您也必須設定 DataKeyNames 屬性,以識別資料來源的索引鍵欄位,以便自動刪除功能能夠運作。
控制項 GridView 提供數個事件,您可以在刪除資料列時用來執行自訂動作。 下表列出可用的事件。
事件 | 描述 |
---|---|
RowDeleted | 發生于按一下資料列的 [刪除] 按鈕時,但在控制項從資料來源中刪除記錄之後 GridView 。 此事件通常用來檢查刪除作業的結果。 |
RowDeleting | 發生于按一下資料列的 [刪除] 按鈕時,但在控制項從資料來源中刪除記錄之前 GridView 。 此事件通常用來取消刪除作業。 |