Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase LoginCancelEventArgs

 

Publicado: julio de 2016

Proporciona datos para un evento cancelable.

Espacio de nombres:   System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

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

public class LoginCancelEventArgs : EventArgs

NombreDescripción
System_CAPS_pubmethodLoginCancelEventArgs()

Inicializa una nueva instancia de la LoginCancelEventArgs clase con el Cancel propiedad establecida en false.

System_CAPS_pubmethodLoginCancelEventArgs(Boolean)

Inicializa una nueva instancia de la LoginCancelEventArgs clase con el Cancel propiedad establecida en el valor especificado.

NombreDescripción
System_CAPS_pubpropertyCancel

Obtiene o establece un valor que indica si se debe cancelar el evento.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

Cuando un componente está a punto de realizar una acción que se puede cancelar, como iniciar sesión en un sitio Web, se provoca un evento cancelable.

La LoginCancelEventArgs clase proporciona el Cancel propiedad para indicar si se debe cancelar el evento. Un LoginCancelEventArgs objeto se usa con controles que tengan acciones cancelables, como el Login (control), el CreateUserWizard control y el PasswordRecovery control.

El siguiente ejemplo de código utiliza el LoggingIn eventos para asegurarse de que el usuario ha escrito una dirección de correo electrónico con formato correcto en el UserName propiedad. Si no, el LoggingIn controlador de eventos cancela el intento de inicio de sesión estableciendo la Cancel propiedad de la LoginCancelEventArgs objeto true. A continuación, el mensaje de error especificado en el InstructionText se muestra la propiedad.

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;
        }
    }
}

El siguiente es el archivo .aspx que puede utilizarse para ejecutar el ejemplo anterior.

<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="Form1" runat="server">
            <asp:Login id="Login1" 
              runat="server" 
              onloggingin="OnLoggingIn">
            </asp:Login>
        </form>
    </body>
</html>

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: