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
|
FormViewDeletedEventArgs, classe
Fournit des données pour l'événement ItemDeleted.
Assembly : System.Web (dans System.Web.dll)
Le type FormViewDeletedEventArgs expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
FormViewDeletedEventArgs | Initialise une nouvelle instance de la classe FormViewDeletedEventArgs. |
| 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é pour l'enregistrement supprimé. |
|
|
Values | Obtient un dictionnaire des paires nom/valeur de champ ne correspondant pas à une clé pour l'enregistrement supprimé. |
| 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 FormView déclenche l'événement ItemDeleted suite à un clic sur le bouton Supprimer (bouton dont la propriété CommandName a la valeur « Delete ») dans le contrôle, mais seulement après que le contrôle FormView a supprimé l'enregistrement. Cela vous permet de fournir une méthode de gestion d'événements qui exécute une routine personnalisée, par exemple la vérification des résultats d'une opération de suppression, lorsque cet événement se produit.
Un objet FormViewDeletedEventArgs est passé à la méthode de gestion 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 la méthode de gestion d'événements en définissant la propriété ExceptionHandled.
Remarque
|
|---|
|
Si une exception se produit pendant l'opération de suppression et que la propriété ExceptionHandled a la valeur false, le contrôle FormView lève à nouveau l'exception. |
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.
L'exemple suivant montre comment utiliser l'objet FormViewDeletedEventArgs passé à la méthode de gestion 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 EmployeeFormView_ItemDeleted(Object sender, FormViewDeletedEventArgs 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 whether the // record was deleted. Sometimes an error might occur that // does not raise an exception, but prevents the delete // operation from completing. if (e.AffectedRows == 1) { MessageLabel.Text = "Record deleted successfully."; } else { MessageLabel.Text = "An error occurred during the delete operation."; } } else { // Insert the code to handle the exception. MessageLabel.Text = e.Exception.Message; // Use the ExceptionHandled property to indicate that the // exception has already been handled. e.ExceptionHandled = true; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>FormViewDeletedEventArgs Example</title> </head> <body> <form id="form1" runat="server"> <h3>FormViewDeletedEventArgs Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" onitemdeleted="EmployeeFormView_ItemDeleted" runat="server"> <itemtemplate> <table> <tr> <td> <asp:image id="EmployeeImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td> <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3> <%# Eval("Title") %> </td> </tr> <tr> <td colspan="2"> <asp:button id="DeleteButton" text="Delete Record" commandname="Delete" runat="server" /> </td> </tr> </table> </itemtemplate> </asp:formview> <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="EmployeeSource" selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]" deletecommand="Delete [Employees] Where [EmployeeID]=@EmployeeID" 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.
