Login.Authenticate Zdarzenie

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Występuje, gdy użytkownik jest uwierzytelniony.

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

Typ zdarzenia

AuthenticateEventHandler

Przykłady

Poniższy przykład kodu używa zdarzenia Authenticate do wywoływania niestandardowego kodu uwierzytelniania specyficznego dla witryny.

<%@ 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>

Uwagi

Zdarzenie Authenticate jest wywoływane, gdy użytkownik używa kontrolki Login do logowania się do witryny sieci Web. Niestandardowe schematy uwierzytelniania mogą używać zdarzenia Authenticate do uwierzytelniania użytkowników.

Uwaga

Gdy użytkownik używa kontrolki Login do logowania się do witryny sieci Web, wszystkie dane w stanie widoku i wszystkie dane pocztowe zostaną utracone. Nie wykonuj akcji w Authenticate przypadku, które polegają na stanie widoku.

Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Uwagi dotyczące dziedziczenia

Niestandardowe schematy uwierzytelniania powinny ustawić Authenticated właściwość , aby wskazać true , że użytkownik został uwierzytelniony.

Gdy użytkownik przesyła swoje informacje logowania, Login kontrolka najpierw zgłasza LoggingIn zdarzenie, a następnie Authenticate zdarzenie i na LoggedIn koniec zdarzenie.

Dotyczy