AuthenticatingEventArgs.Authenticated Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se as credenciais do usuário são válidas.
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
Valor da propriedade
true
se as credenciais do usuário forem válidas; caso contrário, false
.
Exemplos
O exemplo a seguir mostra um manipulador de eventos que passa UserName e Password valores para um provedor de associação personalizado para validar as credenciais do usuário. O manipulador de eventos define Authenticated como o valor retornado do ValidateUser método e define AuthenticationIsComplete como para true
que a AuthenticationService classe não valide as credenciais.
void AuthenticationService_Authenticating(object sender, System.Web.ApplicationServices.AuthenticatingEventArgs e)
{
if (e.UserName.IndexOf("@contoso.com") >= 0)
{
e.Authenticated = Membership.Providers["ContosoSqlProvider"].ValidateUser(e.UserName, e.Password);
}
else if (e.UserName.IndexOf("@fabrikam.com") >= 0)
{
e.Authenticated = Membership.Providers["FabrikamSqlProvider"].ValidateUser(e.UserName, e.Password);
}
else
{
e.Authenticated = Membership.Provider.ValidateUser(e.UserName, e.Password);
}
e.AuthenticationIsComplete = true;
}
Sub AuthenticationService_Authenticating _
(ByVal sender As Object, _
ByVal e As System.Web.ApplicationServices.AuthenticatingEventArgs)
If (e.Username.IndexOf("@contoso.com") >= 0) Then
e.Authenticated = Membership.Providers("ContosoSqlProvider").ValidateUser(e.Username, e.Password)
ElseIf (e.Username.IndexOf("@fabrikam.com") >= 0) Then
e.Authenticated = Membership.Providers("FabrikamSqlProvider").ValidateUser(e.Username, e.Password)
Else
e.Authenticated = Membership.Provider.ValidateUser(e.Username, e.Password)
End If
e.AuthenticationIsComplete = True
End Sub
Comentários
Se você autenticar as credenciais do usuário em um manipulador de eventos para o Authenticating evento, defina a Authenticated propriedade para indicar se as credenciais do usuário são válidas. Se as credenciais do usuário forem válidas e nenhuma validação adicional for necessária, defina Authenticated como true
e AuthenticationIsComplete como true
. Você define a AuthenticationIsComplete propriedade para indicar que o serviço de autenticação deve ignorar as etapas padrão para autenticar um usuário. O valor em Authenticated será usado pela AuthenticationService classe somente se AuthenticationIsComplete for definido como true
. Se AuthenticationIsComplete for false
, a AuthenticationService classe chamará o provedor de associação padrão para validar as credenciais do usuário e, em seguida, substituirá o valor em Authenticated.