AuthenticateEventArgs.Authenticated Właściwość

  • Odwołanie

Definicja

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

Pobiera lub ustawia wartość wskazującą, czy próba uwierzytelnienia użytkownika zakończyła się pomyślnie.

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

Wartość właściwości

Boolean

true jeśli próba uwierzytelnienia zakończyła się pomyślnie; w przeciwnym razie , false.

Przykłady

Poniższy przykład kodu używa Authenticated właściwości z niestandardowym schematem uwierzytelniania, aby wskazać powodzenie lub niepowodzenie próby logowania użytkownika.

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

Authenticated Użyj właściwości w niestandardowych schematach uwierzytelniania zaimplementowanych w procedurze obsługi zdarzeń, Login.Authenticate aby wskazać powodzenie lub niepowodzenie próby logowania użytkownika.

Authenticated Ustawienie właściwości false na wartość wskazuje, że użytkownik witryny sieci Web nie przedstawił prawidłowych poświadczeń, a kontrolka Login powinna zgłosić LoginError zdarzenie oprócz wyświetlania tekstu wskazującego, że próba logowania nie powiodła się. Zdarzenie LoginError umożliwia deweloperowi strony wykonywanie dodatkowych procesów lub akcji, gdy uwierzytelnianie użytkownika nie powiedzie się. Ustawienie Authenticated wskazujące, że użytkownik przedstawił prawidłowe poświadczenia, a Login kontrolka powinna zgłosić LoggedIn zdarzenie i przekierować użytkownika z powrotem do bieżącej strony lub do strony wskazanej przez DestinationPageUrl.true

Dotyczy

Zobacz też