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

Definición

Obtiene o establece un valor que indica si una columna de campo CommandField con un botón Eliminar para cada fila de datos se agrega automáticamente a un control 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

Valor de propiedad

Es true para agregar automáticamente una columna de campo CommandField con un botón Eliminar para cada fila de datos; de lo contrario, es false.true to automatically add a CommandField field column with a Delete button for each data row; otherwise, false. De manera predeterminada, es false.The default is false.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar AutoGenerateDeleteButton la propiedad para habilitar la característica de eliminación automática de GridView un control.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>

Comentarios

Cuando un control de origen de datos que admite la eliminación está enlazado a GridView un GridView control, el control puede aprovechar las capacidades del control de origen de datos y proporcionar funcionalidad de eliminación automática.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.

Nota

Para que un control de origen de datos elimine los datos, debe configurarse para que elimine los datos.For a data source control to delete data, it must be configured to delete data. Para configurar un control de origen de datos para eliminar registros, vea la documentación del control de origen de datos específico.To configure a data source control to delete records, see the documentation for the specific data source control.

Cuando la AutoGenerateDeleteButton propiedad está establecida en true, se agrega automáticamente al GridView control una CommandField columna (representada por un objeto) con un botón Eliminar para cada fila de datos.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. Al hacer clic en el botón eliminar de una fila, se quita permanentemente ese registro del origen de datos.Clicking the Delete button for a row permanently removes that record from the data source.

Nota

También debe establecer la DataKeyNames propiedad para identificar el campo o los campos clave del origen de datos para que funcione la característica de eliminación automática.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.

El GridView control proporciona varios eventos que se pueden usar para realizar una acción personalizada cuando se elimina una fila.The GridView control provides several events that you can use to perform a custom action when a row is deleted. En la tabla siguiente se enumeran los eventos disponibles.The following table lists the available events.

eventoEvent DescripciónDescription
RowDeleted Se produce cuando se hace clic en el botón eliminar de una fila, GridView pero después de que el control elimine el registro del origen de datos.Occurs when a row's Delete button is clicked, but after the GridView control deletes the record from the data source. Este evento se usa a menudo para comprobar los resultados de la operación de eliminación.This event is often used to check the results of the delete operation.
RowDeleting Se produce cuando se hace clic en el botón eliminar de una fila, GridView pero antes de que el control elimine el registro del origen de datos.Occurs when a row's Delete button is clicked, but before the GridView control deletes the record from the data source. Este evento suele usarse para cancelar la operación de eliminación.This event is often used to cancel the deleting operation.

Se aplica a

Consulte también: