GridView.AutoGenerateDeleteButton GridView.AutoGenerateDeleteButton GridView.AutoGenerateDeleteButton GridView.AutoGenerateDeleteButton Property

定義

データ行ごとに Delete ボタンを持つ CommandField フィールド列を自動的に GridView コントロールに追加するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether a CommandField field column with a Delete button for each data row is automatically added to a GridView control.

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

プロパティ値

データ行ごとに Delete ボタンを持つ CommandField フィールド列を自動的に追加する場合は true。それ以外の場合は falsetrue to automatically add a CommandField field column with a Delete button for each data row; otherwise, false. 既定値は、false です。The default is false.

次の例では、使用する方法、AutoGenerateDeleteButtonの自動削除機能を有効にするプロパティをGridViewコントロール。The following example demonstrates how to use the AutoGenerateDeleteButton property to enable the automatic deleting feature of a GridView control.

<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コントロールは、データ ソース コントロールの機能を活用し、削除機能を提供します。When a data source control that supports deleting is bound to a GridView control, the GridView control can take advantage of the data source control's capabilities and provide automatic deleting functionality.

注意

データ ソース コントロールがデータを削除するには、データの削除、構成する必要があります。For a data source control to delete data, it must be configured to delete data. レコードを削除するデータ ソース コントロールを構成するには、特定のデータ ソース コントロールのドキュメントを参照してください。To configure a data source control to delete records, see the documentation for the specific data source control.

ときに、AutoGenerateDeleteButtonプロパティに設定されてtrue、列 (によって表される、CommandFieldオブジェクト) の各データの削除 ボタンで行が自動的に追加、GridViewコントロール。When the AutoGenerateDeleteButton property is set to true, a column (represented by a CommandField object) with a Delete button for each data row is automatically added to the GridView control. 行の削除 ボタンをクリックすると、完全には、データ ソースからそのレコードを削除します。Clicking the Delete button for a row permanently removes that record from the data source.

注意

設定することも必要があります、DataKeyNamesキー フィールドまたは自動削除機能が動作するデータ ソースのフィールドを識別するプロパティ。You must also set the DataKeyNames property to identify the key field or fields of the data source for the automatic deleting feature to work.

GridViewコントロールが行を削除するときに、カスタム アクションを実行するのに使用できるいくつかのイベントを提供します。The GridView control provides several events that you can use to perform a custom action when a row is deleted. 次の表には、使用可能なイベントが一覧表示します。The following table lists the available events.

eventEvent 説明Description
RowDeleted 後で、行の Delete ボタンがクリックされたときに発生します、GridViewコントロールがデータ ソースからレコードを削除します。Occurs when a row's Delete button is clicked, but after the GridView control deletes the record from the data source. このイベントは、削除操作の結果を確認するよく使用されます。This event is often used to check the results of the delete operation.
RowDeleting 発生する前に、行の Delete ボタンがクリックされたとき、GridViewコントロールがデータ ソースからレコードを削除します。Occurs when a row's Delete button is clicked, but before the GridView control deletes the record from the data source. このイベントは削除操作をキャンセルによく使用されます。This event is often used to cancel the deleting operation.

適用対象

こちらもご覧ください