AuthenticationService.Login(String, String, String, Boolean) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Controlla le credenziali utente e crea un ticket di autenticazione (cookie) se le credenziali sono valide.
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 BooleanParametri
- username
- String
Nome utente da convalidare.
- password
- String
Password per l'utente specificato.
- customCredential
- String
Valore o valori da convalidare oltre a username e password, se presenti.
- isPersistent
- Boolean
Valore che indica se il ticket di autenticazione rimane valido tra le sessioni.
Valori restituiti
true se le credenziali utente sono valide; in caso contrario, false.
- Attributi
Eccezioni
userName o password è null.
Commenti
Il Login metodo convalida le credenziali utente tramite un provider di appartenenze. È possibile usare il provider di appartenenze predefinito o specificare un provider di appartenenze personalizzato in fase di esecuzione. La AuthenticationService classe passa userName e password al metodo del provider di ValidateUser appartenenze, ma non passa customCredential. Se ValidateUser restituisce true, AuthenticationService crea un ticket di autenticazione come cookie. Impostare il isPersistent parametro su true per creare un ticket di autenticazione che dura oltre la sessione corrente.
Note
Usare sempre il servizio di autenticazione insieme al livello secure sockets (SSL, tramite HTTPS) per proteggere i dati sensibili.
Il Login metodo genera l'evento Authenticating e l'evento CreatingCookie . Creare un gestore eventi per Authenticating personalizzare l'autenticazione, ad esempio controllare i valori in customCredential o convalidare le credenziali tramite un provider di appartenenze non predefinito. I valori in customCredential non vengono convalidati dal provider di appartenenze predefinito. Per personalizzare il cookie di autenticazione, creare un gestore eventi per CreatingCookie.
Note
Non chiamare il Login metodo dal codice in esecuzione nel server Web. Chiamare il Login metodo solo come parte di un servizio WCF. Per altre informazioni, vedere ASP.NET Authentication.
