GridView.AutoGenerateDeleteButton Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Recebe ou define um valor que indica se uma CommandField coluna de campo com um botão Delete para cada linha de dados é automaticamente adicionada a um GridView controlo.

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 Propriedade

Boolean

true para adicionar automaticamente uma CommandField coluna de campo com um botão Delete para cada linha de dados; caso contrário, false. A predefinição é false.

Exemplos

O exemplo seguinte demonstra como usar a AutoGenerateDeleteButton propriedade para ativar a funcionalidade de eliminação automática de um GridView controlo.

<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>

Observações

Quando um controlo de fonte de dados que suporta a eliminação está vinculado a um GridView controlo, este GridView pode tirar partido das capacidades do controlo de fonte de dados e fornecer funcionalidade de eliminação automática.

Note

Para que um controlo de fonte de dados apague dados, tem de estar configurado para eliminar dados. Para configurar um controlo de fonte de dados para eliminar registos, consulte a documentação do controlo de fonte de dados específico.

Quando a AutoGenerateDeleteButton propriedade é definida para true, uma coluna (representada por um CommandField objeto) com um botão Delete para cada linha de dados é automaticamente adicionada ao GridView controlo. Clicar no botão Delete de uma linha remove permanentemente esse registo da fonte de dados.

Note

Também deve definir a DataKeyNames propriedade para identificar o(s) campo(s) chave da fonte de dados para que a funcionalidade de eliminação automática funcione.

O GridView controlo fornece vários eventos que pode usar para realizar uma ação personalizada quando uma linha é eliminada. A tabela seguinte lista os eventos disponíveis.

Event Description
RowDeleted Ocorre quando o botão Delete de uma linha é clicado, mas depois de o GridView controlo apagar o registo da fonte de dados. Este evento é frequentemente usado para verificar os resultados da operação de eliminação.
RowDeleting Ocorre quando o botão Delete de uma linha é clicado, mas antes de o GridView controlo eliminar o registo da fonte de dados. Este evento é frequentemente usado para cancelar a operação de eliminação.

Aplica-se a

Ver também