AuthenticateEventArgs.Authenticated Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, выполнена ли попытка проверки подлинности пользователя.
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 Значение , если попытка проверки подлинности выполнена успешно; falseв противном случае .
Примеры
В следующем примере кода свойство используется Authenticated с пользовательской схемой проверки подлинности, чтобы указать успешность или сбой попытки входа пользователя.
<%@ 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 обработчике событий, чтобы указать успешность или сбой попытки входа пользователя.
Authenticated Задание свойства, false указывающее, что пользователь веб-сайта не представил допустимые учетные данные, и Login элемент управления должен вызвать LoginError событие в дополнение к отображению текста, указывающего, что попытка входа не прошла успешно. Событие LoginError позволяет разработчику страницы выполнять дополнительные процессы или действия, если проверка подлинности пользователя не выполнена. Параметр Authenticated , указывающий true , что пользователь представил допустимые учетные данные, и Login элемент управления должен вызвать LoggedIn событие и перенаправить пользователя обратно на текущую страницу или на страницу, указанную на ней DestinationPageUrl.