Cette documentation est archivée et n’est pas conservée.

GridView.AutoGenerateDeleteButton, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

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.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public virtual bool AutoGenerateDeleteButton { get; set; }
/** @property */
public boolean get_AutoGenerateDeleteButton ()

/** @property */
public void set_AutoGenerateDeleteButton (boolean value)

public function get AutoGenerateDeleteButton () : boolean

public function set AutoGenerateDeleteButton (value : boolean)

Valeur de la propriété

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.

Lorsqu'un contrôle de source de données prenant en charge la suppression est lié à un contrôle GridView, le contrôle GridView peut tirer parti des fonctionnalités du contrôle de source de données et fournir la fonctionnalité de suppression automatique.

RemarqueRemarque

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 afin de supprimer des enregistrements, consultez la documentation du contrôle de source de données spécifique.

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

RemarqueRemarque

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

Le contrôle GridView fournit plusieurs événements que vous pouvez utiliser pour exécuter 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 l'utilisateur clique sur le bouton Supprimer d'une ligne, mais une fois que le contrôle GridView 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 l'utilisateur clique sur le bouton Supprimer d'une ligne, mais avant que le contrôle GridView n'ait supprimé l'enregistrement de la source de données. Cet événement est souvent utilisé pour annuler l'opération de suppression.

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


<%@ Page language="C#" %>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView Edit Example</h3>

      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogeneratedeletebutton="true"
        autogenerateeditbutton="true"
        datakeynames="CustomerID"  
        runat="server">
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        deletecommand="Delete from Customers where CustomerID = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: