Partilhar via


GridView.AutoGenerateDeleteButton Propriedade

Definição

Obtém ou define um valor que indica se uma coluna do campo CommandField com um botão Excluir para cada linha de dados é adicionada automaticamente a um controle 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 da propriedade

Boolean

true para adicionar automaticamente uma coluna de campo CommandField com um botão Excluir para cada linha de dados; caso contrário, false. O padrão é false.

Exemplos

O exemplo a seguir demonstra como usar a AutoGenerateDeleteButton propriedade para habilitar o recurso de exclusão automática de um GridView controle.

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

Comentários

Quando um controle da fonte de dados que dá suporte à exclusão está associado a um GridView controle, o GridView controle pode aproveitar os recursos do controle da fonte de dados e fornecer funcionalidade de exclusão automática.

Observação

Para que um controle da fonte de dados exclua dados, ele deve ser configurado para excluir dados. Para configurar um controle de fonte de dados para excluir registros, consulte a documentação do controle específico da fonte de dados.

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

Observação

Você também deve definir a DataKeyNames propriedade para identificar o campo de chave ou os campos da fonte de dados para que o recurso de exclusão automática funcione.

O GridView controle fornece vários eventos que você pode usar para executar uma ação personalizada quando uma linha é excluída. A tabela a seguir lista os eventos disponíveis.

Evento Descrição
RowDeleted Ocorre quando o botão Excluir de uma linha é clicado, mas depois que o GridView controle exclui o registro da fonte de dados. Esse evento geralmente é usado para verificar os resultados da operação de exclusão.
RowDeleting Ocorre quando o botão Excluir de uma linha é clicado, mas antes que o GridView controle exclua o registro da fonte de dados. Esse evento geralmente é usado para cancelar a operação de exclusão.

Aplica-se a

Confira também