AuthenticateEventArgs.Authenticated Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu označující, zda pokus o ověření uživatele byl úspěšný.
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
Hodnota vlastnosti
true
pokud byl pokus o ověření úspěšný; v opačném případě . false
Příklady
Následující příklad kódu používá Authenticated vlastnost s vlastním schématem ověřování k označení úspěšného nebo neúspěšného pokusu o přihlášení uživatele.
<%@ 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>
Poznámky
Authenticated Vlastnost ve vlastních schématech ověřování implementovaných v obslužné Login.Authenticate rutině události použijte k označení úspěšného nebo neúspěšného pokusu o přihlášení uživatele.
Authenticated Nastavení vlastnosti na false
znamená, že uživatel webu nepředstavil platné přihlašovací údaje a Login ovládací prvek by měl kromě zobrazení textu, který značí, že pokus o přihlášení nebyl úspěšný, vyvolá LoginError událost. Událost LoginError umožňuje vývojáři stránky, aby v případě neúspěšného ověření uživatele provedl další procesy nebo akci. Nastavení Authenticated na true
označuje, že uživatel předložil platné přihlašovací údaje a Login ovládací prvek by měl vyvolat LoggedIn událost a přesměrovat uživatele zpět na aktuální stránku nebo na stránku označenou .DestinationPageUrl