GridView.AutoGenerateDeleteButton Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.

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é

Boolean

true pour ajouter automatiquement une colonne de champs CommandField avec un bouton Supprimer pour chaque ligne de données ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple suivant montre comment utiliser la AutoGenerateDeleteButton propriété pour activer la fonctionnalité de suppression automatique d’un GridView contrôle.

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

Notes

Pour qu’un contrôle de source de données supprime des données, il doit être configuré pour supprimer des données. Pour configurer un contrôle de source de données pour supprimer des enregistrements, consultez la documentation relative au contrôle de source de données spécifique.

Lorsque la AutoGenerateDeleteButton propriété est définie truesur , une colonne (représentée par un CommandField objet) avec un bouton Supprimer pour chaque ligne de données est automatiquement ajoutée au GridView contrôle. Cliquer sur le bouton Supprimer pour une ligne supprime définitivement cet enregistrement de la source de données.

Notes

Vous devez également définir la DataKeyNames propriété pour identifier le ou les champs de clé de la source de données pour que la fonctionnalité de suppression automatique fonctionne.

Le GridView contrôle fournit plusieurs événements que vous pouvez utiliser pour effectuer une action personnalisée lorsqu’une ligne est supprimée. Le tableau suivant répertorie les événements disponibles.

Événement Description
RowDeleted Se produit lorsque le bouton Supprimer d’une ligne est cliqué, mais une fois que le GridView contrôle a supprimé l’enregistrement de la source de données. Cet événement est souvent utilisé pour vérifier les résultats de l’opération de suppression.
RowDeleting Se produit lorsque le bouton Supprimer d’une ligne est cliqué, mais avant que le GridView contrôle supprime l’enregistrement de la source de données. Cet événement est souvent utilisé pour annuler l’opération de suppression.

S’applique à

Voir aussi