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
|
FormViewInsertedEventArgs, classe
Fournit des données pour l'événement ItemInserted.
Assembly : System.Web (dans System.Web.dll)
Le type FormViewInsertedEventArgs expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
FormViewInsertedEventArgs | Initialise une nouvelle instance de la classe FormViewInsertedEventArgs. |
| Nom | Description | |
|---|---|---|
|
AffectedRows | Obtient le nombre de lignes affectées par l'opération d'insertion. |
|
|
Exception | Obtient l'exception (s'il y en a une) qui a été levée pendant l'opération d'insertion. |
|
|
ExceptionHandled | Obtient ou définit une valeur indiquant si une exception levée pendant l'opération d'insertion a été gérée dans le gestionnaire d'événements. |
|
|
KeepInInsertMode | Obtient ou définit une valeur indiquant si le contrôle FormView doit rester en mode insertion après une opération d'insertion. |
|
|
Values | Obtient un dictionnaire qui contient les paires valeur/nom du champ de l'enregistrement inséré. |
| 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 ItemInserted lors d'un clic sur un bouton d'insertion (bouton dont la propriété CommandName a la valeur « Insert ») situé dans le contrôle, mais après insertion de l'enregistrement par le contrôle FormView. 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 d'insertion, chaque fois que cet événement se produit.
Un objet FormViewInsertedEventArgs 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 rencontrées. Pour déterminer le nombre d'enregistrements affectés par l'opération d'insertion, utilisez la propriété AffectedRows. Utilisez la propriété Exception pour déterminer si des exceptions se sont produites. 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. Si vous devez accéder aux valeurs de l'enregistrement inséré, utilisez la propriété Values.
Par défaut, le contrôle FormView retourne au mode spécifié par la propriété DefaultMode après une opération d'insertion. Si une exception se produit pendant l'opération d'insertion, vous pouvez maintenir le contrôle FormView en mode insertion en affectant true à la propriété KeepInInsertMode.
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 FormViewDeletedEventArgs, consultez le constructeur FormViewInsertedEventArgs.
L'exemple suivant montre comment utiliser l'objet FormViewInsertedEventArgs passé à la méthode de gestion d'événements pour l'événement ItemInserted afin de déterminer si une exception s'est produite pendant une opération d'insertion.
Note de sécurité
|
|---|
|
Cet exemple comporte une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script. |
<%@ 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_ItemInserted(Object sender, FormViewInsertedEventArgs e) { // Use the Exception property to determine whether an exception // occurred during the insert operation. if (e.Exception == null) { // Use the AffectedRows property to determine whether the // record was inserted. Sometimes an error might occur that // does not raise an exception, but prevents the insert // operation from completing. if (e.AffectedRows == 1) { MessageLabel.Text = "Record inserted successfully."; } else { MessageLabel.Text = "An error occurred during the insert operation."; // Use the KeepInInsertMode property to remain in insert mode // when an error occurs during the insert operation. e.KeepInInsertMode = true; } } 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; e.KeepInInsertMode = true; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>FormViewInsertedEventArgs Example</title> </head> <body> <form id="form1" runat="server"> <h3>FormViewInsertedEventArgs Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" emptydatatext="No employees found." oniteminserted="EmployeeFormView_ItemInserted" runat="server"> <itemtemplate> <table> <tr> <td rowspan="5"> <asp:image id="CompanyLogoImage" imageurl="~/Images/Logo.jpg" alternatetext="Company logo" runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b>Name:</b> </td> <td> <%# Eval("FirstName") %> <%# Eval("LastName") %> </td> </tr> <tr> <td> <b>Title:</b> </td> <td> <%# Eval("Title") %> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="NewButton" text="New" commandname="New" runat="server"/> </td> </tr> </table> </itemtemplate> <insertitemtemplate> <table> <tr> <td rowspan="4"> <asp:image id="CompanyLogoEditImage" imageurl="~/Images/Logo.jpg" alternatetext="Company logo" runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b><asp:Label runat="server" AssociatedControlID="FirstNameInsertTextBox" Text="Name" />:</b> </td> <td> <asp:textbox id="FirstNameInsertTextBox" text='<%# Bind("FirstName") %>' runat="server"/> <asp:textbox id="LastNameInsertTextBox" text='<%# Bind("LastName") %>' runat="server"/> </td> </tr> <tr> <td> <b><asp:Label runat="server" AssociatedControlID="TitleInsertTextBox" Text="Title" />:</b> </td> <td> <asp:textbox id="TitleInsertTextBox" text='<%# Bind("Title") %>' runat="server"/> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="InsertButton" text="Insert" commandname="Insert" runat="server"/> <asp:linkbutton id="CancelButton" text="Cancel" commandname="Cancel" runat="server"/> </td> </tr> </table> </insertitemtemplate> </asp:formview> <br/><br/> <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]" insertcommand="Insert Into [Employees] ([LastName], [FirstName], [Title]) VALUES (@LastName, @FirstName, @Title)" 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.
