Exporter (0) Imprimer
Développer tout

LoginCancelEventArgs, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Fournit des données pour un événement annulable.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class LoginCancelEventArgs : EventArgs
public class LoginCancelEventArgs extends EventArgs
public class LoginCancelEventArgs extends EventArgs

Un événement annulable est déclenché lorsqu'un composant va exécuter une action qui peut être annulée, par exemple la connexion à un site Web.

La classe LoginCancelEventArgs fournit la propriété Cancel pour indiquer si l'événement doit être annulé. Un objet LoginCancelEventArgs est utilisé avec les contrôles qui ont des actions annulables, par exemple les contrôles Login, CreateUserWizard et PasswordRecovery.

L'exemple de code suivant utilise l'événement LoggingIn pour vérifier que l'utilisateur a entré une adresse de messagerie correcte dans la propriété UserName. Si tel n'est pas le cas, le gestionnaire d'événements LoggingIn annule la tentative de connexion en affectant la valeur true à la propriété Cancel de l'objet LoginCancelEventArgs. Ensuite, le message d'erreur spécifié dans la propriété InstructionText s'affiche.

public partial class LoginCancelEventArgscs_aspx : System.Web.UI.Page
{

    bool IsValidEmail(string strIn)
    {
        // Return true if strIn is in valid e-mail format.
        return System.Text.RegularExpressions.Regex.IsMatch(strIn, 
            @"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$");
    }
    
    protected void OnLoggingIn(object sender, System.Web.UI.WebControls.LoginCancelEventArgs e)
    {
        if (!IsValidEmail(Login1.UserName))
        {
            Login1.InstructionText = "You must enter a valid e-mail address.";
            e.Cancel = true;
        }
        else
        {
            Login1.InstructionText = String.Empty;
        }
    }
}

L'élément ci-après représente le fichier .aspx permettant d'exécuter l'exemple précédent.

<%@ Page Language="C#" CodeFile="LoginCancelEventArgs.cs" Inherits="LoginCancelEventArgscs_aspx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html>
    <body>
        <form id="Form1" runat="server">
            <asp:Login id="Login1" 
              runat="server" 
              onloggingin="OnLoggingIn">
            </asp:Login>
        </form>
    </body>
</html>

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.EventArgs
    System.Web.UI.WebControls.LoginCancelEventArgs
       System.Web.UI.WebControls.MailMessageEventArgs

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

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.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft