GridView.AutoGenerateDeleteButton GridView.AutoGenerateDeleteButton GridView.AutoGenerateDeleteButton GridView.AutoGenerateDeleteButton Property

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.Gets or sets a value indicating whether a CommandField field column with a Delete button for each data row is automatically added to a GridView control.

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à

true per aggiungere automaticamente una colonna associata a campo CommandField con un pulsante Elimina per ciascuna riga di dati, altrimenti false.true to automatically add a CommandField field column with a Delete button for each data row; otherwise, false. Il valore predefinito è false.The default is false.

Esempi

Nell'esempio seguente viene illustrato come utilizzare la AutoGenerateDeleteButton proprietà per abilitare la funzionalità di eliminazione automatica di GridView un controllo.The following example demonstrates how to use the AutoGenerateDeleteButton property to enable the automatic deleting feature of a 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>

Commenti

Quando un controllo origine dati che supporta l'eliminazione è associato a GridView un controllo, GridView il controllo può sfruttare le funzionalità del controllo origine dati e fornire funzionalità di eliminazione automatica.When a data source control that supports deleting is bound to a GridView control, the GridView control can take advantage of the data source control's capabilities and provide automatic deleting functionality.

Nota

Per eliminare i dati, un controllo origine dati deve essere configurato per eliminare i dati.For a data source control to delete data, it must be configured to delete data. Per configurare un controllo origine dati per eliminare i record, vedere la documentazione per il controllo origine dati specifico.To configure a data source control to delete records, see the documentation for the specific data source control.

Quando la AutoGenerateDeleteButton proprietà è impostata su true, al GridView controllo viene aggiunta automaticamente una CommandField colonna, rappresentata da un oggetto, con un pulsante Elimina per ogni riga di dati.When the AutoGenerateDeleteButton property is set to true, a column (represented by a CommandField object) with a Delete button for each data row is automatically added to the GridView control. Quando si fa clic sul pulsante Elimina per una riga, il record viene rimosso definitivamente dall'origine dati.Clicking the Delete button for a row permanently removes that record from the data source.

Nota

È inoltre necessario impostare la DataKeyNames proprietà per identificare il campo o i campi chiave dell'origine dati per il funzionamento della funzionalità di eliminazione automatica.You must also set the DataKeyNames property to identify the key field or fields of the data source for the automatic deleting feature to work.

Il GridView controllo fornisce diversi eventi che è possibile utilizzare per eseguire un'azione personalizzata quando viene eliminata una riga.The GridView control provides several events that you can use to perform a custom action when a row is deleted. Nella tabella seguente sono elencati gli eventi disponibili.The following table lists the available events.

eventEvent DescriptionDescription
RowDeleted Si verifica quando viene fatto clic sul pulsante Elimina di una riga, ma GridView dopo che il controllo ha eliminato il record dall'origine dati.Occurs when a row's Delete button is clicked, but after the GridView control deletes the record from the data source. Questo evento viene spesso usato per verificare i risultati dell'operazione di eliminazione.This event is often used to check the results of the delete operation.
RowDeleting Si verifica quando viene fatto clic sul pulsante Elimina di una riga, ma GridView prima che il controllo elimini il record dall'origine dati.Occurs when a row's Delete button is clicked, but before the GridView control deletes the record from the data source. Questo evento viene spesso usato per annullare l'operazione di eliminazione.This event is often used to cancel the deleting operation.

Si applica a

Vedi anche