GridView.AutoGenerateDeleteButton Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Partilhar via