Login.Authenticate イベント

定義

ユーザーが認証されたときに発生します。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 

イベントの種類

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>

注釈

イベントは、 Authenticate ユーザーがコントロールを使用し Login て Web サイトにログインすると発生します。The 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 Web サイトにログインすると、ビューステートおよびすべてのポストデータ内のすべてのデータが失われます。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.

適用対象

こちらもご覧ください