GridView.AutoGenerateDeleteButton Propriété

Définition

Obtient ou définit une valeur indiquant si une colonne de champs CommandField avec un bouton Supprimer pour chaque ligne de données est ajoutée automatiquement à un contrôle GridView.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

Valeur de propriété

true pour ajouter automatiquement une colonne de champs CommandField avec un bouton Supprimer pour chaque ligne de données ; sinon, false.true to automatically add a CommandField field column with a Delete button for each data row; otherwise, false. La valeur par défaut est false.The default is false.

Exemples

L’exemple suivant montre comment utiliser la AutoGenerateDeleteButton propriété pour activer la fonctionnalité de suppression automatique d’un GridView contrôle.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>

Remarques

Lorsqu’un contrôle de source de données qui prend en charge la GridView suppression est lié GridView à un contrôle, le contrôle peut tirer parti des fonctionnalités du contrôle de source de données et fournir des fonctionnalités de suppression automatique.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.

Notes

Pour qu’un contrôle de source de données supprime des données, il doit être configuré pour supprimer des données.For a data source control to delete data, it must be configured to delete data. Pour configurer un contrôle de source de données afin de supprimer des enregistrements, consultez la documentation relative au contrôle de source de données spécifique.To configure a data source control to delete records, see the documentation for the specific data source control.

Lorsque la AutoGenerateDeleteButton propriété a la truevaleur, une colonne (représentée par un CommandField objet) avec un bouton Supprimer pour GridView chaque ligne de données est automatiquement ajoutée au contrôle.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. Le fait de cliquer sur le bouton Supprimer pour une ligne supprime définitivement cet enregistrement de la source de données.Clicking the Delete button for a row permanently removes that record from the data source.

Notes

Vous devez également définir la DataKeyNames propriété pour identifier le ou les champs clés de la source de données pour que la fonction de suppression automatique fonctionne.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.

Le GridView contrôle fournit plusieurs événements que vous pouvez utiliser pour exécuter une action personnalisée lorsqu’une ligne est supprimée.The GridView control provides several events that you can use to perform a custom action when a row is deleted. Le tableau suivant répertorie les événements disponibles.The following table lists the available events.

événementEvent DescriptionDescription
RowDeleted Se produit lorsque l’utilisateur clique sur le bouton supprimer d’une ligne GridView , mais après que le contrôle a supprimé l’enregistrement de la source de données.Occurs when a row's Delete button is clicked, but after the GridView control deletes the record from the data source. Cet événement est souvent utilisé pour vérifier les résultats de l’opération de suppression.This event is often used to check the results of the delete operation.
RowDeleting Se produit lorsque l’utilisateur clique sur le bouton supprimer d’une ligne GridView , mais avant que le contrôle supprime l’enregistrement de la source de données.Occurs when a row's Delete button is clicked, but before the GridView control deletes the record from the data source. Cet événement est souvent utilisé pour annuler l’opération de suppression.This event is often used to cancel the deleting operation.

S’applique à

Voir aussi