GridView.AutoGenerateDeleteButton Свойство

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.dll

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

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

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 удалением записи из источника данных элемент управления. Это событие часто используется для отмены операции удаления.

См. также раздел

• CommandField
• AutoGenerateEditButton
• AutoGenerateSelectButton
• AutoGenerateColumns
• DeleteCommand