AuthenticationService.Login(String, String, String, Boolean) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Verifica as credenciais do utilizador e cria um ticket 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 -> boolPublic Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As BooleanParâ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.
- isPersistent
- Boolean
Um valor que indica se o ticket de autenticação permanece válido entre sessões.
Devoluções
true se as credenciais do utilizador forem válidas; caso contrário, false.
- Atributos
Exceções
userName ou password é null.
Observações
O Login método valida as credenciais dos utilizadores através de um fornecedor de membros. Pode usar o fornecedor de membros por defeito ou especificar um fornecedor de subscrição personalizado em tempo de execução. A AuthenticationService aula é aprovada userName pelo password método do ValidateUser fornecedor de membros, mas não é aprovada customCredential. Se ValidateUser devolver true, AuthenticationService cria um ticket de autenticação como cookie. Defina o isPersistent parâmetro para true criar um ticket de autenticação que dure para além da sessão atual.
Note
Use sempre o serviço de autenticação juntamente com a camada de sockets seguros (SSL, usando HTTPS) para proteger dados sensíveis.
O Login método eleva o Authenticating evento e o CreatingCookie evento. Crie um gestor de eventos para Authenticating personalizar a autenticação, como verificar os valores ou customCredential validar credenciais através de um fornecedor de membros não padrão. Os valores em customCredential não são validados pelo fornecedor de membros padrão. Para personalizar o cookie de autenticação, crie um gestor de eventos para CreatingCookie.
Note
Não chame o Login método a partir de código que está a ser executado no servidor Web. Chama o Login método apenas como parte de um serviço WCF. Para mais informações, consulte ASP.NET Autenticação.
