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
|
FormView.ModeChanging, événement
Se produit lorsque le contrôle FormView bascule entre les modes édition, insertion et lecture seule, mais avant le changement de mode.
Assembly : System.Web (dans System.Web.dll)
L'événement ModeChanging est déclenché lorsqu'un contrôle FormView tente de basculer entre les modes édition, insertion et lecture seule, mais avant que le mode ne change réellement. Cela vous permet de fournir une méthode de gestion d'événements qui exécute une routine personnalisée, par exemple la configuration du contrôle FormView pour un mode spécifique ou l'annulation de la modification du mode, chaque fois que cet événement se produit.
Un objet FormViewModeEventArgs est passé à la méthode de gestion d'événements qui vous permet de déterminer le mode vers lequel le contrôle FormView bascule, pour déterminer si l'événement ModeChanging a été déclenché à la suite de l'annulation par l'utilisateur d'une opération de modification ou pour indiquer qu'une opération d'insertion doit être annulée. Pour déterminer le nouveau mode, utilisez la propriété NewMode. Vous pouvez également utiliser la propriété NewMode pour basculer vers un autre mode en lui affectant l'une des valeurs d'énumération FormViewMode. Utilisez la propriété CancelingEdit pour déterminer si l'utilisateur a annulé une opération de modification. Pour annuler une opération d'insertion, affectez true à la propriété Cancel.
Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.
L'exemple suivant montre comment utiliser l'événement ModeChanging pour masquer la ligne de pagineur lorsque le contrôle FormView passe en mode édition.
<%@ 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_ModeChanging(Object sender, FormViewModeEventArgs e) { // Use the NewMode property to determine the mode to which the // FormView control is transitioning. switch (e.NewMode) { case FormViewMode.Edit: // Hide the pager row and clear the Label control // when transitioning to edit mode. EmployeeFormView.AllowPaging = false; MessageLabel.Text = ""; break; case FormViewMode.ReadOnly: // Display the pager row and confirmation message // when transitioning to edit mode. EmployeeFormView.AllowPaging = true; if (e.CancelingEdit) { MessageLabel.Text = "Update canceled."; } else { MessageLabel.Text = "Update completed."; } break; case FormViewMode.Insert: // Cancel the mode change if the FormView // control attempts to transition to insert // mode. e.Cancel = true; break; default: MessageLabel.Text = "Unsupported mode."; break; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>FormViewModeEventArgs Example</title> </head> <body> <form id="form1" runat="server"> <h3>FormViewModeEventArgs Example</h3> <asp:formview id="EmployeeFormView" datasourceid="EmployeeSource" allowpaging="true" datakeynames="EmployeeID" emptydatatext="No employees found." onmodechanging="EmployeeFormView_ModeChanging" runat="server"> <itemtemplate> <table> <tr> <td rowspan="6"> <asp:image id="EmployeeImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' 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> <b>Hire Date:</b> </td> <td> <%# Eval("HireDate","{0:d}") %> </td> </tr> <tr style="height:150" valign="top"> <td> <b>Address:</b> </td> <td> <%# Eval("Address") %><br/> <%# Eval("City") %> <%# Eval("Region") %> <%# Eval("PostalCode") %><br/> <%# Eval("Country") %> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="Edit" text="Edit" commandname="Edit" runat="server"/> </td> </tr> </table> </itemtemplate> <edititemtemplate> <table> <tr> <td rowspan="6"> <asp:image id="EmployeeEditImage" imageurl='<%# Eval("PhotoPath") %>' alternatetext='<%# Eval("LastName") %>' runat="server"/> </td> <td colspan="2"> </td> </tr> <tr> <td> <b><asp:Label runat="server" AssociatedControlID="FirstNameUpdateTextBox" Text="Name" />:</b> </td> <td> <asp:textbox id="FirstNameUpdateTextBox" text='<%# Bind("FirstName") %>' accesskey="n" tabindex="1" runat="server"/> <asp:textbox id="LastNameUpdateTextBox" text='<%# Bind("LastName") %>' accesskey="l" tabindex="2" runat="server"/> </td> </tr> <tr> <td> <b><asp:Label runat="server" AssociatedControlID="TitleUpdateTextBox" Text="Title" />:</b> </td> <td> <asp:textbox id="TitleUpdateTextBox" text='<%# Bind("Title") %>' accesskey="t" tabindex="3" runat="server"/> </td> </tr> <tr> <b><asp:Label runat="server" AssociatedControlID="HireDateUpdateTextBox" Text="Hire Date" />:</b> <td> <asp:textbox id="HireDateUpdateTextBox" text='<%# Bind("HireDate", "{0:d}") %>' accesskey="h" tabindex="4" runat="server" /> </td> </tr> <tr style="height:150" valign="top"> <td> <b><asp:Label runat="server" AssociatedControlID="AddressUpdateTextBox" Text="Address" />:</b> </td> <td> <asp:textbox id="AddressUpdateTextBox" text='<%# Bind("Address") %>' accesskey="a" tabindex="5" runat="server"/> <br/> <asp:textbox id="CityUpdateTextBox" text='<%# Bind("City") %>' accesskey="c" tabindex="6" runat="server"/> <asp:textbox id="RegionUpdateTextBox" text='<%# Bind("Region") %>' width="40" accesskey="r" tabindex="7" runat="server"/> <asp:textbox id="PostalCodeUpdateTextBox" text='<%# Bind("PostalCode") %>' width="60" accesskey="p" tabindex="8" runat="server"/> <br/> <asp:textbox id="CountryUpdateTextBox" text='<%# Bind("Country") %>' accesskey="u" tabindex="9" runat="server"/> </td> </tr> <tr> <td colspan="2"> <asp:linkbutton id="UpdateButton" text="Update" tabindex="10" commandname="Update" runat="server"/> <asp:linkbutton id="CancelButton" text="Cancel" tabindex="11" commandname="Cancel" runat="server"/> </td> </tr> </table> </edititemtemplate> </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], [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath] From [Employees]" updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region, [PostalCode]=@PostalCode, [Country]=@Country 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.
