AuthenticationService.ValidateUser(String, String, String) Método
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.
Autentica as credenciais do usuário sem emitir um tíquete de autenticação.
public:
bool ValidateUser(System::String ^ username, System::String ^ password, System::String ^ customCredential);
[System.ServiceModel.OperationContract]
public bool ValidateUser (string username, string password, string customCredential);
[<System.ServiceModel.OperationContract>]
member this.ValidateUser : string * string * string -> bool
Public Function ValidateUser (username As String, password As String, customCredential As String) As Boolean
Parâmetros
- username
- String
O nome de usuário a ser validado.
- password
- String
A senha do usuário especificado.
- customCredential
- String
O valor ou os valores a serem validados além de username
e password
, se houver.
Retornos
true
se as credenciais do usuário forem válidas; caso contrário, false
.
- Atributos
Exceções
userName
ou password
é null
.
Comentários
O ValidateUser método autentica as credenciais do usuário, mas não define um cookie de autenticação. Sem um cookie de autenticação, o usuário não será conectado mesmo se as credenciais forem válidas.
Use o ValidateUser método quando precisar verificar se as credenciais de um usuário são válidas sem receber um cookie de autenticação. Por exemplo, você pode fazer isso se o cookie de autenticação já estiver armazenado em um aplicativo cliente, mas quiser verificar se as credenciais do usuário ainda são válidas quando uma nova sessão é iniciada.
O ValidateUser método aciona o Authenticating evento, mas não aciona o CreatingCookie evento.
Observação
Não chame o ValidateUser método do código que está sendo executado no servidor Web. Você chama o ValidateUser método apenas como parte de um serviço WCF. Para obter mais informações, consulte Autenticação ASP.NET.