Login.Authenticate Evento

Definición

Aparece cuando se autentica un usuario.

public:
 event System::Web::UI::WebControls::AuthenticateEventHandler ^ Authenticate;
public event System.Web.UI.WebControls.AuthenticateEventHandler Authenticate;
member this.Authenticate : System.Web.UI.WebControls.AuthenticateEventHandler 
Public Custom Event Authenticate As AuthenticateEventHandler 

Tipo de evento

Ejemplos

En el ejemplo de código siguiente se usa el Authenticate evento para llamar al código de autenticación personalizado específico del sitio.

<%@ 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">
private bool SiteSpecificAuthenticationMethod(string UserName, string Password)
{
    // Insert code that implements a site-specific custom 
    // authentication method here.
    //
    // This example implementation always returns false.
    return false;
}

private void OnAuthenticate(object sender, AuthenticateEventArgs e)
{
    bool Authenticated = false;
    Authenticated = SiteSpecificAuthenticationMethod(Login1.UserName, Login1.Password);

    e.Authenticated = Authenticated;
}

</script>

<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"
                OnAuthenticate="OnAuthenticate">
            </asp:Login>
        </form>
    </body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
Function SiteSpecificAuthenticationMethod(ByVal UserName As String, ByVal Password As String) As Boolean
    ' Insert code that implements a site-specific custom 
    ' authentication method here.
    '
    ' This example implementation always returns false.
    Return False
End Function

Sub OnAuthenticate(ByVal sender As Object, ByVal e As AuthenticateEventArgs)
    Dim Authenticated As Boolean
    Authenticated = SiteSpecificAuthenticationMethod(Login1.UserName, Login1.Password)

    e.Authenticated = Authenticated
End Sub


</script>

<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"
                OnAuthenticate="OnAuthenticate">
            </asp:Login>

        </form>
    </body>
</html>

Comentarios

El Authenticate evento se genera cuando un usuario usa el Login control para iniciar sesión en un sitio web. Los esquemas de autenticación personalizados pueden usar el Authenticate evento para autenticar a los usuarios.

Nota

Cuando un usuario usa el Login control para iniciar sesión en un sitio web, se pierden todos los datos del estado de vista y todos los datos posteriores. No realice acciones en caso Authenticate de que se basen en el estado de vista.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.

Notas a los desarrolladores de herederos

Los esquemas de autenticación personalizados deben establecer la Authenticated propiedad en true para indicar que se ha autenticado un usuario.

Cuando un usuario envía su información de inicio de sesión, el Login control genera primero el LoggingIn evento, luego el Authenticate evento y, por último, el LoggedIn evento.

Se aplica a

Consulte también