AuthenticateEventArgs.Authenticated Eigenschaft
Definition
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.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, 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, setPublic Property Authenticated As BooleanEigenschaftswert
truewenn 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 wurden, um den Erfolg oder Fehler des Anmeldeversuchs des Benutzers anzugeben.
Durch Festlegen der Authenticated Eigenschaft wird false angegeben, dass der Websitebenutzer keine gültigen Anmeldeinformationen angezeigt hat, und das Login Steuerelement sollte das LoginError Ereignis zusätzlich zum Anzeigen von Text auslösen, 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. Einstellung Authenticated , die true angibt, dass der Benutzer gültige Anmeldeinformationen angezeigt hat und das Login Steuerelement das LoggedIn Ereignis auslösen und den Benutzer zurück zur aktuellen Seite oder zu der seite umleiten soll, die durch DestinationPageUrlangegeben ist.
