GridView.AutoGenerateDeleteButton プロパティ

定義

データ行ごとに 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.

プロパティがにtrue設定されている場合、データ行GridViewごとCommandFieldに [削除] ボタンを持つ (オブジェクトによって表される) 列がコントロールに自動的に追加されます。 AutoGenerateDeleteButtonWhen 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.

適用対象

こちらもご覧ください