GridView.AutoGenerateDeleteButton Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

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.

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

Boolean

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. De manera predeterminada, es false.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la AutoGenerateDeleteButton propiedad para habilitar la característica de eliminación automática de un 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 un GridView control, el GridView control puede aprovechar las funcionalidades del control de origen de datos y proporcionar funcionalidad de eliminación automática.

Nota

Para que un control de origen de datos elimine los datos, debe configurarse para eliminar datos. Para configurar un control de origen de datos para eliminar registros, consulte la documentación del control de origen de datos específico.

Cuando la AutoGenerateDeleteButton propiedad se establece trueen , una columna (representada por un CommandField objeto) con un botón Eliminar para cada fila de datos se agrega automáticamente al GridView control . Al hacer clic en el botón Eliminar de una fila se quita permanentemente ese registro del origen de datos.

Nota

También debe establecer la DataKeyNames propiedad para identificar el campo de clave o los campos del origen de datos para que funcione la característica de eliminación automática.

El GridView control proporciona varios eventos que puede usar para realizar una acción personalizada cuando se elimina una fila. En la tabla siguiente se enumeran los eventos disponibles.

Evento Descripción
RowDeleted Se produce cuando se hace clic en el botón Eliminar de una fila, pero después de que el GridView control elimine el registro del origen de datos. Este evento se usa a menudo para comprobar los resultados de la operación de eliminación.
RowDeleting Se produce cuando se hace clic en el botón Eliminar de una fila, pero antes de que el GridView control elimine el registro del origen de datos. Este evento se usa a menudo para cancelar la operación de eliminación.

Se aplica a

Consulte también