Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
DetailsViewDeletedEventArgs, classe
Fournit des données pour l'événement ItemDeleted.
Assembly : System.Web (dans System.Web.dll)
Le type DetailsViewDeletedEventArgs expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
DetailsViewDeletedEventArgs | Initialise une nouvelle instance de la classe DetailsViewDeletedEventArgs. |
| Nom | Description | |
|---|---|---|
|
AffectedRows | Obtient le nombre de lignes affectées par l'opération de suppression. |
|
|
Exception | Obtient l'exception (s'il y en a une) qui a été levée pendant l'opération de suppression. |
|
|
ExceptionHandled | Obtient ou définit une valeur indiquant si une exception levée pendant l'opération de suppression a été gérée dans le gestionnaire d'événements. |
|
|
Keys | Obtient un dictionnaire trié de paires nom/valeur de champ clé qui contient les noms et les valeurs des champs clés des éléments supprimés. |
|
|
Values | Obtient un dictionnaire des paires nom/valeur de champs ne correspondant pas à une clé pour l'élément à supprimer. |
| Nom | Description | |
|---|---|---|
|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
Le contrôle DetailsView déclenche l'événement ItemDeleted suite à un clic sur le bouton Supprimer (bouton dont la propriété CommandName a la valeur "Delete"), mais seulement après que le contrôle DetailsView a supprimé l'enregistrement. Cela vous permet de fournir un gestionnaire d'événements qui exécute une routine personnalisée, par exemple la vérification des résultats d'une opération de suppression, chaque fois que cet événement se produit.
Un objet DetailsViewDeletedEventArgs est passé au gestionnaire d'événements qui vous permet de déterminer le nombre d'enregistrements affectés et toutes les exceptions éventuellement levées. Pour déterminer le nombre d'enregistrements affectés par l'opération de suppression, utilisez la propriété AffectedRows. Pour déterminer si des exceptions se sont produites, utilisez la propriété Exception. Vous pouvez également indiquer si l'exception a été gérée dans le gestionnaire d'événements en définissant la propriété ExceptionHandled. Si vous souhaitez accéder aux paires nom/valeur des champs clés et des champs ne correspondant pas à une clé de l'enregistrement supprimé, utilisez respectivement les propriétés Keys et Values.
Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.
Pour obtenir la liste des valeurs initiales des propriétés d'une instance de la classe DetailsViewDeletedEventArgs, consultez le constructeur DetailsViewDeletedEventArgs.
L'exemple suivant montre comment utiliser l'objet DetailsViewDeletedEventArgs passé au gestionnaire d'événements pour l'événement ItemDeleted afin de déterminer si une exception s'est produite pendant une opération de suppression.
<%@ Page language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> void StoresDetailView_ItemDeleted(Object sender, DetailsViewDeletedEventArgs e) { // Use the Exception property to determine whether an exception // occurred during the delete operation. if (e.Exception == null) { // Use the AffectedRows property to determine the numbers of // rows affected by the delete operation. if (e.AffectedRows == 1) { MessageLabel.Text = e.AffectedRows.ToString() + " record deleted successfully."; } else { MessageLabel.Text = e.AffectedRows.ToString() + " records deleted successfully."; } } else { // Insert the code to handle the exception. MessageLabel.Text = e.Exception.Message; // Use the ExceptionHandled property to indicate that the // exception is already handled. e.ExceptionHandled = true; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>DetailsViewDeletedEventArgs Example</title> </head> <body> <form id="form1" runat="server"> <h3>DetailsViewDeletedEventArgs Example</h3> <asp:detailsview id="CustomerDetailsView" datasourceid="DetailsViewSource" datakeynames="CustomerID" autogeneratedeletebutton="true" autogeneraterows="true" allowpaging="true" onitemdeleted="StoresDetailView_ItemDeleted" runat="server"> <fieldheaderstyle backcolor="Navy" forecolor="White"/> </asp:detailsview> <asp:label id="MessageLabel" forecolor="Red" runat="server"/> <!-- 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" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" deletecommand="Delete [Customers] Where [CustomerID]=@CustomerID" connectionstring= "<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"/> </form> </body> </html>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
