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

Note

Чтобы элемент управления источниками данных удалял данные, его необходимо настроить для удаления данных. Сведения о настройке системы управления источниками данных для удаления записей см. в документации по конкретному элементу управления версиями данных.

AutoGenerateDeleteButton Если для свойства задано trueзначение, столбец (представленный CommandField объектом) с кнопкой Delete для каждой строки данных автоматически добавляется в GridView элемент управления. Нажатие кнопки "Удалить" для строки окончательно удаляет эту запись из источника данных.

Note

Необходимо также задать DataKeyNames свойство, чтобы определить ключевое поле или поля источника данных для работы функции автоматического удаления.

Элемент GridView управления предоставляет несколько событий, которые можно использовать для выполнения пользовательского действия при удалении строки. В следующей таблице перечислены доступные события.

Событие Description
RowDeleted Происходит при нажатии кнопки удаления строки, но после GridView удаления записи из источника данных элемент управления. Это событие часто используется для проверки результатов операции удаления.
RowDeleting Происходит при нажатии кнопки удаления строки, но перед GridView удалением записи из источника данных элемент управления. Это событие часто используется для отмены операции удаления.

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

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