Login.Authenticate Login.Authenticate Login.Authenticate Login.Authenticate Event

Определение

Происходит после прохождения пользователем проверки подлинности.Occurs when a user is authenticated.

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 

Примеры

В следующем примере кода Authenticate событие используется для вызова пользовательского кода проверки подлинности, относящегося к конкретному сайту.The following code example uses the Authenticate event to call site-specific custom authentication code.

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

Комментарии

Событие возникает, когда пользователь Login использует элемент управления для входа на веб-сайт. AuthenticateThe Authenticate event is raised when a user uses the Login control to log in to a Web site. Пользовательские схемы проверки подлинности Authenticate могут использовать событие для проверки подлинности пользователей.Custom authentication schemes can use the Authenticate event to authenticate users.

Примечание

Когда пользователь использует Login элемент управления для входа на веб-сайт, теряются все данные в состоянии представления и все данные POST.When a user uses the Login control to log in to a Web site, all data in the view state and all post data is lost. Не выполняйте действия в Authenticate событии, которое зависит от состояния представления.Do not perform actions in the Authenticate event that rely on the view state.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about handling events, see Handling and Raising Events.

Примечания для тех, кто наследует этот метод

Пользовательские схемы проверки подлинности Authenticated должны установить true свойство в значение, чтобы указать, что пользователь прошел проверку подлинности.Custom authentication schemes should set the Authenticated property to true to indicate that a user has been authenticated.

Когда пользователь отправляет свои Login данные для входа, элемент управления сначала LoggingIn создает событие, затем Authenticate событие и, наконец LoggedIn , событие.When a user submits his or her login information, the Login control first raises the LoggingIn event, then the Authenticate event, and finally the LoggedIn event.

Применяется к

Дополнительно