AuthenticateEventArgs.Authenticated Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab oder legt ihn fest, um anzugeben, ob der Authentifizierungsversuch eines Benutzers erfolgreich war.

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

Eigenschaftswert

Boolean

true, wenn der Authentifizierungsversuch erfolgreich war; andernfalls false.

Beispiele

Im folgenden Codebeispiel wird die Authenticated -Eigenschaft mit einem benutzerdefinierten Authentifizierungsschema verwendet, um den Erfolg oder Fehler des Anmeldeversuchs eines Benutzers anzugeben.

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

Hinweise

Verwenden Sie die Authenticated -Eigenschaft in benutzerdefinierten Authentifizierungsschemas, die Login.Authenticate im Ereignishandler implementiert sind, um den Erfolg oder Fehler des Anmeldeversuchs des Benutzers anzugeben.

Wenn Sie die Authenticated -Eigenschaft auf festlegen false , wird angegeben, dass der Websitebenutzer keine gültigen Anmeldeinformationen vorgelegt hat und das Login Steuerelement das LoginError Ereignis auslösen sollte, zusätzlich zum Anzeigen von Text, der angibt, dass der Anmeldeversuch nicht erfolgreich war. Das LoginError Ereignis ermöglicht es dem Seitenentwickler, zusätzliche Prozesse oder Aktionen auszuführen, wenn die Benutzerauthentifizierung nicht erfolgreich ist. Die Einstellung Authenticated auf true gibt an, dass der Benutzer gültige Anmeldeinformationen vorgelegt hat und das Login Steuerelement das LoggedIn Ereignis auslösen und den Benutzer zurück zur aktuellen Seite oder zur durch DestinationPageUrlangegebenen Seite umleiten soll.

Gilt für:

Freigeben über