AuthenticationService.ValidateUser(String, String, String) Método

Definição

Espaço de Nomes:
System.Web.ApplicationServices
Assemblagem:
System.Web.Extensions.dll

Autentica as credenciais do utilizador sem emitir um ticket 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 utilizador a validar.

password
String

A palavra-passe do utilizador especificado.

customCredential
String

O valor ou valores a validar além de username e password, se existirem.

Devoluções

Boolean

true se as credenciais de utilizador forem válidas; caso contrário, false.

Atributos
OperationContractAttribute

Exceções

ArgumentNullException

userName ou password é null.

Observações

O ValidateUser método autentica as credenciais do utilizador, mas não define um cookie de autenticação. Sem um cookie de autenticação, o utilizador não estará ligado mesmo que as credenciais sejam válidas.

Use o ValidateUser método quando tiver de verificar se as credenciais de um utilizador são válidas sem receber um cookie de autenticação. Por exemplo, pode fazer isto se o cookie de autenticação já estiver armazenado numa aplicação cliente, mas quiser verificar se as credenciais do utilizador continuam válidas quando uma nova sessão começar.

O ValidateUser método eleva o Authenticating evento, mas não eleva o CreatingCookie evento.

Note

Não chame o ValidateUser método a partir de código que está a ser executado no servidor Web. Chama o ValidateUser método apenas como parte de um serviço WCF. Para mais informações, consulte ASP.NET Autenticação.

Aplica-se a

Ver também