DetailsView.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 le contrôle intégré pour supprimer l'enregistrement actuel s'affiche dans un contrôle DetailsView.

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 afficher le contrôle intégré afin de supprimer l'enregistrement actuel ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple de code suivant montre comment utiliser la AutoGenerateDeleteButton propriété pour afficher le contrôle intégré afin de supprimer l’enregistrement actif.


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView AutoGenerateDeleteButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateDeleteButton Example</h3>
                
        <asp:detailsview id="CustomersDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- 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="DetailsViewSource" runat="server" 
            ConnectionString=
              "<%$ ConnectionStrings:NorthWindConnectionString%>"
            InsertCommand="INSERT INTO [Customers]([CustomerID], 
              [CompanyName], [Address], [City], [PostalCode], [Country]) 
              VALUES (@CustomerID, @CompanyName, @Address, @City, 
              @PostalCode, @Country)"
            SelectCommand="Select [CustomerID], [CompanyName], 
              [Address], [City], [PostalCode], [Country] From 
              [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView AutoGenerateDeleteButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateDeleteButton Example</h3>
                
        <asp:detailsview id="CustomersDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- 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="DetailsViewSource" runat="server" 
            ConnectionString=
              "<%$ ConnectionStrings:NorthWindConnectionString%>"
            InsertCommand="INSERT INTO [Customers]([CustomerID], 
              [CompanyName], [Address], [City], [PostalCode], [Country]) 
              VALUES (@CustomerID, @CompanyName, @Address, @City, 
              @PostalCode, @Country)"
            SelectCommand="Select [CustomerID], [CompanyName], 
              [Address], [City], [PostalCode], [Country] From 
              [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

Remarques

Lorsqu’un DetailsView contrôle est lié à un objet qui hérite de DataSourceView et que la CanDelete propriété retourne true, le DetailsView contrôle peut tirer parti des fonctionnalités du contrôle de source de données et fournir des fonctionnalités de suppression automatique.

Remarque

Pour qu’un SqlDataSourceView objet supprime des données, la SqlDataSource.DeleteCommand propriété de l’objet sous-jacent SqlDataSource doit être définie avec une instruction de requête delete.

Lorsque la propriété a la AutoGenerateDeleteButtontruevaleur , un CommandField champ de ligne avec un bouton Supprimer s’affiche automatiquement dans le DetailsView contrôle . Cliquer sur le bouton Supprimer supprime définitivement cet enregistrement de la source de données.

Remarque

Vous devez également définir la DataKeyNames propriété pour que la fonctionnalité de suppression automatique fonctionne.

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

Événement Description
ItemDeleted Se produit lorsque l’utilisateur clique sur le bouton Supprimer, mais après que le DetailsView 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.
ItemDeleting Se produit lorsque l’utilisateur clique sur le bouton Supprimer, mais avant que le DetailsView contrôle supprime l’enregistrement de la source de données. Cet événement est souvent utilisé pour annuler l’opération de suppression.

La valeur de AutoGenerateDeleteButton est stockée dans l’état d’affichage.

S’applique à

Voir aussi