Condividi tramite


GridView.AutoGenerateDeleteButton Proprietà

Definizione

Ottiene o imposta un valore che indica se a un controllo CommandField viene aggiunta automaticamente una colonna associata a campo GridView con un pulsante Elimina per ciascuna riga di dati.

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

Valore della proprietà

Boolean

true per aggiungere automaticamente una colonna associata a campo CommandField con un pulsante Elimina per ciascuna riga di dati, altrimenti false. Il valore predefinito è false.

Esempio

Nell'esempio seguente viene illustrato come usare la AutoGenerateDeleteButton proprietà per abilitare la funzionalità di eliminazione automatica di un GridView controllo.

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

Commenti

Quando un controllo origine dati che supporta l'eliminazione è associato a un GridView controllo, il GridView controllo può sfruttare le funzionalità del controllo origine dati e fornire funzionalità di eliminazione automatica.

Nota

Per un controllo origine dati per eliminare i dati, è necessario configurarlo per eliminare i dati. Per configurare un controllo origine dati per eliminare i record, vedere la documentazione per il controllo dell'origine dati specifico.

Quando la AutoGenerateDeleteButton proprietà è impostata su true, una colonna (rappresentata da un CommandField oggetto) con un pulsante Delete per ogni riga di dati viene aggiunta automaticamente al GridView controllo. Facendo clic sul pulsante Elimina per una riga viene rimosso definitivamente il record dall'origine dati.

Nota

È anche necessario impostare la DataKeyNames proprietà per identificare il campo chiave o i campi dell'origine dati per il funzionamento della funzionalità di eliminazione automatica.

Il GridView controllo fornisce diversi eventi che è possibile usare per eseguire un'azione personalizzata quando viene eliminata una riga. Nella tabella seguente sono elencati gli eventi disponibili.

Event Descrizione
RowDeleted Si verifica quando viene fatto clic sul pulsante Delete di una riga, ma dopo che il controllo elimina il GridView record dall'origine dati. Questo evento viene spesso usato per controllare i risultati dell'operazione di eliminazione.
RowDeleting Si verifica quando viene fatto clic sul pulsante Elimina di una riga, ma prima che il controllo elimini il GridView record dall'origine dati. Questo evento viene spesso usato per annullare l'operazione di eliminazione.

Si applica a

Vedi anche