DetailsView.AutoGenerateDeleteButton Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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 AutoGenerateDeleteButtontrue
valeur , 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.