AuthenticateEventArgs.Authenticated AuthenticateEventArgs.Authenticated AuthenticateEventArgs.Authenticated AuthenticateEventArgs.Authenticated Property

定義

ユーザーの認証が成功したかどうかを示す値を取得または設定します。Gets or sets a value indicating whether a user's authentication attempt succeeded.

public:
 property bool Authenticated { bool get(); void set(bool value); };
public bool Authenticated { get; set; }
member this.Authenticated : bool with get, set
Public Property Authenticated As Boolean

プロパティ値

認証が成功した場合は true。それ以外の場合は falsetrue if the authentication attempt succeeded; otherwise, false.

次のコード例では、Authenticatedをユーザーのログイン試行の成否を示すためにカスタム認証スキームを持つプロパティです。The following code example uses the Authenticated property with a custom authentication scheme to indicate the success or failure of a user's login attempt.

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

注釈

使用して、Authenticatedで実装されたカスタム認証スキームでプロパティ、Login.Authenticateイベント ハンドラーをユーザーのログイン試行の成否を示します。Use the Authenticated property in custom authentication schemes implemented in the Login.Authenticate event handler to indicate the success or failure of the user's login attempt.

設定、AuthenticatedプロパティをfalseWeb サイトのユーザーが有効な資格情報を表示がないことを示します、Loginコントロールを生成する必要があります、LoginErrorログインの試行を示すテキストを表示するだけでなく、イベントが成功しなかった。Setting the Authenticated property to false indicates that the Web site user has not presented valid credentials and the Login control should raise the LoginError event in addition to displaying text that indicates the login attempt was not successful. LoginErrorイベントにより、ページ開発者は追加のプロセスまたはユーザー認証が成功しなかった場合に発生するアクションがあります。The LoginError event enables the page developer to have additional processes or action occur when user authentication is not successful. 設定Authenticatedtrue、ユーザーが有効な資格情報を表示されることを示します、Loginコントロールを生成する必要があります、LoggedInイベントとで指定されたユーザーに現在のページまたはページにリダイレクトDestinationPageUrlします。Setting Authenticated to true indicates that the user has presented valid credentials and the Login control should raise the LoggedIn event and redirect the user back to the current page or to the page indicated by DestinationPageUrl.

適用対象

こちらもご覧ください