Compartilhar via

AuthenticationService.Login(String, String, String, Boolean) Método

  • Referência

Definição

Namespace:
System.Web.ApplicationServices
Assembly:
System.Web.Extensions.dll

Verifica as credenciais de usuário e cria um tíquete de autenticação (cookie) se as credenciais são válidas.

public:
 bool Login(System::String ^ username, System::String ^ password, System::String ^ customCredential, bool isPersistent);
[System.ServiceModel.OperationContract]
public bool Login (string username, string password, string customCredential, bool isPersistent);
[<System.ServiceModel.OperationContract>]
member this.Login : string * string * string * bool -> bool
Public Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) 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.

isPersistent
Boolean

Um valor que indica se o tíquete de autenticação permanece válido entre diferentes sessões.

Retornos

Boolean

true se as credenciais do usuário forem válidas; caso contrário, false.

Atributos
OperationContractAttribute

Exceções

ArgumentNullException

userName ou password é null.

Comentários

O Login método valida as credenciais do usuário por meio de um provedor de associação. Você pode usar o provedor de associação padrão ou especificar um provedor de associação personalizado em tempo de execução. A AuthenticationService classe passa userName e password para o método do provedor de ValidateUser associação, mas não passa customCredential. Se ValidateUser retornar true, AuthenticationService criará um tíquete de autenticação como um cookie. Defina o isPersistent parâmetro como true para criar um tíquete de autenticação que dure além da sessão atual.

Observação

Sempre use o serviço de autenticação junto com a SSL (camada de soquetes seguros, usando HTTPS) para proteger dados confidenciais.

O Login método aciona o Authenticating evento e o CreatingCookie evento . Crie um manipulador de eventos para Authenticating personalizar a autenticação, como verificar os valores em customCredential ou validar credenciais por meio de um provedor de associação não padrão. Os valores em customCredential não são validados pelo provedor de associação padrão. Para personalizar o cookie de autenticação, crie um manipulador de eventos para CreatingCookie.

Observação

Não chame o Login método do código que está sendo executado no servidor Web. Você chama o Login método apenas como parte de um serviço WCF. Para obter mais informações, consulte Autenticação ASP.NET.

Aplica-se a

Confira também