GridView.AutoGenerateDeleteButton Свойство

Определение

Возвращает или задает значение, указывающее, добавляется ли поле столбца 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

Значение свойства

true для автоматического добавления поля столбца CommandField с кнопкой "Удалить" для каждой строки данных; в противном случае — false.true 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значение, CommandField столбец (представленный объектом) с кнопкой Удалить для GridView каждой строки данных автоматически добавляется в элемент управления. 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.

событиеEvent ОписаниеDescription
RowDeleted Происходит при нажатии кнопки удаления строки, но после того, как 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 Происходит при нажатии кнопки удаления строки, но до того, как 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.

Применяется к

Дополнительно