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
|
FormViewDeleteEventArgs, classe
Fournit des données pour l'événement ItemDeleting.
System.EventArgs
System.ComponentModel.CancelEventArgs
System.Web.UI.WebControls.FormViewDeleteEventArgs
Assembly : System.Web (dans System.Web.dll)
Le type FormViewDeleteEventArgs expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
FormViewDeleteEventArgs | Initialise une nouvelle instance de la classe FormViewDeleteEventArgs. |
| Nom | Description | |
|---|---|---|
|
Cancel | Obtient ou définit une valeur indiquant si l'événement doit être annulé. (Hérité de CancelEventArgs.) |
|
|
Keys | Obtient un dictionnaire ordonné de paires nom/valeur de champs clés pour l'enregistrement à supprimer. |
|
|
RowIndex | Obtient l'index de l'enregistrement qui est supprimé de la source de données. |
|
|
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 FormView déclenche l'événement ItemDeleting suite à un clic sur le bouton Supprimer du contrôle (bouton dont la propriété CommandName a la valeur "Delete"), mais avant que le contrôle FormView ne supprime 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 d'un enregistrement avant sa suppression, chaque fois que cet événement se produit.
Un objet FormViewDeleteEventArgs est passé à la méthode de gestion d'événements, ce qui vous permet de déterminer l'index de l'enregistrement supprimé et d'indiquer que l'opération de suppression doit être annulée. Pour déterminer l'index d'un enregistrement, utilisez la propriété RowIndex. Pour annuler l'opération de suppression, affectez à la propriété Cancel la valeur true. Vous pouvez également accéder aux champs clés et aux champs ne correspondant pas à une clé en utilisant respectivement les propriétés Keys et Values. Ces valeurs sont utiles si vous souhaitez vérifier l'enregistrement avant de le supprimer.
Remarque
|
|---|
|
Il est possible de modifier les valeurs des champs clés et valeurs des champs ne correspondant pas à une clé dans les propriétés Keys et Values, respectivement. Si vous modifiez ces valeurs, l'enregistrement qui correspond aux nouvelles valeurs sera supprimé. |
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 FormViewDeleteEventArgs, consultez le constructeur FormViewDeleteEventArgs.
L'exemple suivant montre comment utiliser l'objet FormViewDeleteEventArgs passé à la méthode de gestion d'événements pour l'événement ItemDeleting afin d'annuler 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_ItemDeleting(Object sender, FormViewDeleteEventArgs e) { // Get the employee ID, name, and job title from the Keys and Values // properties. String keyValue = e.Keys["EmployeeID"].ToString(); String employeeName = e.Values["FirstName"].ToString() + " " + e.Values["LastName"].ToString(); String title = e.Values["Title"].ToString(); // Cancel the delete operation if the user attempts to // delete a protected record. In this example, records for // employees with a "Sales Manager" job title are protected. if (title.Equals("Sales Manager")) { e.Cancel = true; MessageLabel.Text = "You cannot delete record " + e.RowIndex.ToString() + ". " + employeeName + " (Employee Number " + keyValue.ToString() + ") is protected."; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>FormViewDeleteEventArgs Example</title> </head> <body> <form id="form1" runat="server"> <h3>FormViewDeleteEventArgs Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" onitemdeleting="EmployeeFormView_ItemDeleting" runat="server"> <itemtemplate> <table> <tr> <td> <asp:image id="EmployeeImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td> <asp:label id="FirstNameLabel" text='<%#Bind("FirstName")%>' font-bold="true" runat="server"/> <asp:label id="LastNameLabel" text='<%#Bind("LastName")%>' font-bold="true" runat="server"/> <br/> <asp:label id="TitleLabel" text='<%#Bind("Title")%>' runat="server"/> </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.
Si vous souhaitez y participer,
