ServerValidateEventArgs, classe
Assembly : System.Web (dans system.web.dll)
Un ServerValidateEventArgs est passé au gestionnaire d'événements ServerValidate pour fournir des données d'événement au gestionnaire. L'événement ServerValidate est déclenché lorsque la validation est effectuée sur le serveur. Cela vous permet d'exécuter une routine de validation personnalisée côté serveur sur la valeur d'un contrôle d'entrée (avec un contrôle CustomValidator lui étant associé) dans le gestionnaire d'événements.
La valeur à valider est déterminée en utilisant la propriété Value. Une fois que votre code a déterminé si la valeur est valide, stockez les résultats de la validation dans la propriété IsValid.
Pour obtenir la liste des valeurs de propriétés initiales d'une instance de ServerValidateEventArgs, consultez le constructeur ServerValidateEventArgs.
Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.
| Rubrique | Emplacement |
|---|---|
| Procédure pas à pas : validation des entrées d'utilisateur dans une page Web Forms | Génération d'applications Web ASP.NET dans Visual Studio |
| Procédure pas à pas : validation des entrées d'utilisateur dans une page Web Forms | Génération d'applications à l'aide de Visual Web Developer |
L'exemple suivant illustre l'utilisation d'un ServerValidateEventArgs pour passer des données d'événement à un gestionnaire d'événements personnalisé pour l'événement ServerValidate. Notez que la propriété Value de ServerValidateEventArgs est utilisée pour déterminer la valeur à valider, tandis que la propriété IsValid est utilisée pour stocker les résultats de la validation.
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void ValidateBtn_OnClick(object sender, EventArgs e) { // Display whether the page passed validation. if (Page.IsValid) { Message.Text = "Page is valid."; } else { Message.Text = "Page is not valid!"; } } void ServerValidation(object source, ServerValidateEventArgs args) { try { // Test whether the value entered into the text box is even. int i = int.Parse(args.Value); args.IsValid = ((i%2) == 0); } catch(Exception ex) { args.IsValid = false; } } </script> </head> <body> <form runat="server"> <h3>CustomValidator ServerValidate Example</h3> <asp:Label id="Message" Text="Enter an even number:" Font-Name="Verdana" Font-Size="10pt" runat="server"/> <p> <asp:TextBox id="Text1" runat="server" /> <asp:CustomValidator id="CustomValidator1" ControlToValidate="Text1" Display="Static" ErrorMessage="Not an even number!" ForeColor="green" Font-Name="verdana" Font-Size="10pt" OnServerValidate="ServerValidation" runat="server"/> <p> <asp:Button id="Button1" Text="Validate" OnClick="ValidateBtn_OnClick" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void ValidateBtn_OnClick(object sender, EventArgs e) { // Display whether the page passed validation. if (Page.IsValid) { Message.Text = "Page is valid."; } else { Message.Text = "Page is not valid!"; } } void ServerValidation(object source, ServerValidateEventArgs args) { try { // Test whether the value entered into the text box is even. int i = int.Parse(args.Value); args.IsValid = ((i%2) == 0); } catch(Exception ex) { args.IsValid = false; } } void Page_Load(object sender, EventArgs e) { // Manually register the event-handling method for the // ServerValidate event of the CustomValidator control. CustomValidator1.ServerValidate += new ServerValidateEventHandler(this.ServerValidation); } </script> </head> <body> <form runat="server"> <h3>CustomValidator ServerValidate Example</h3> <asp:Label id="Message" Text="Enter an even number:" Font-Name="Verdana" Font-Size="10pt" runat="server"/> <p> <asp:TextBox id="Text1" runat="server" /> <asp:CustomValidator id="CustomValidator1" ControlToValidate="Text1" Display="Static" ErrorMessage="Not an even number!" ForeColor="green" Font-Name="verdana" Font-Size="10pt" runat="server"/> <p> <asp:Button id="Button1" Text="Validate" OnClick="ValidateBtn_OnClick" runat="server"/> </form> </body> </html>
- AspNetHostingPermission pour opérer dans un environnement hébergé. Valeur de la demande : LinkDemand. Valeur d'autorisation : Minimal.
- AspNetHostingPermission pour opérer dans un environnement hébergé. Valeur de la demande : InheritanceDemand. Valeur d'autorisation : Minimal.
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.