AuthenticationService.Login(String, String, String, Boolean) Metodo

Definizione

Spazio dei nomi:

System.Web.ApplicationServices

Assembly:

System.Web.Extensions.dll

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 -> bool

Public Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As Boolean

Parametri

username

String

Nome utente da convalidare.

password

String

Password dell'utente specificato.

customCredential

String

Valori da convalidare oltre a username e password, se presenti.

isPersistent

Boolean

Valore che indica se il ticket di autenticazione resta valido per più sessioni.

Restituisce

Boolean

true se le credenziali utente sono valide; in caso contrario, false.

Attributi

OperationContractAttribute

Eccezioni

ArgumentNullException

userName o password è null.

Commenti

Il Login metodo convalida le credenziali utente tramite un provider di appartenenza. È possibile usare il provider di appartenenza predefinito o specificare un provider di appartenenza personalizzato in fase di esecuzione. La AuthenticationService classe passa userName e password al metodo del provider di ValidateUser appartenenza, ma non passa customCredential. Se ValidateUser restituisce true, AuthenticationService crea un ticket di autenticazione come cookie. Impostare il isPersistent parametro su per true creare un ticket di autenticazione che dura oltre la sessione corrente.

Nota

Usare sempre il servizio di autenticazione insieme al livello secure sockets (SSL, usando HTTPS) per proteggere i dati sensibili.

Il Login metodo genera l'evento e l'evento AuthenticatingCreatingCookie . Creare un gestore eventi per Authenticating personalizzare l'autenticazione, ad esempio controllare i valori in customCredential o convalidare le credenziali tramite un provider di appartenenza non predefinito. I valori in customCredential non vengono convalidati dal provider di appartenenza predefinito. Per personalizzare il cookie di autenticazione, creare un gestore eventi per CreatingCookie.

Nota

Non chiamare il Login metodo dal codice in esecuzione nel server Web. Si chiama il Login metodo solo come parte di un servizio WCF. Per altre informazioni, vedere autenticazione ASP.NET.

Vedi anche

• Panoramica del servizio di autenticazione di Windows Communication Foundation