Partager via

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

  • Référence

Définition

Espace de noms:
System.Web.ApplicationServices
Assembly:
System.Web.Extensions.dll

Vérifie les informations d'identification de l'utilisateur et crée un ticket d'authentification (cookie) si les informations d'identification sont valides.

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

Paramètres

username
String

Le nom de l'utilisateur à valider.

password
String

Mot de passe de l'utilisateur spécifié.

customCredential
String

La valeur ou les valeurs à valider en plus de username et password, le cas échéant.

isPersistent
Boolean

Une valeur qui indique si le ticket d'authentification reste valide d'une session à une autre.

Retours

Boolean

true si les informations d'identification de l'utilisateur sont valides ; sinon, false.

Attributs
OperationContractAttribute

Exceptions

ArgumentNullException

userName ou password est null.

Remarques

La Login méthode valide les informations d’identification de l’utilisateur via un fournisseur d’appartenances. Vous pouvez utiliser le fournisseur d’appartenances par défaut ou spécifier un fournisseur d’appartenance personnalisé au moment de l’exécution. La AuthenticationService classe transmet userName et password à la méthode du ValidateUser fournisseur d’appartenances customCredential, mais ne transmet pas . Si ValidateUser retourne true, AuthenticationService crée un ticket d’authentification en tant que cookie. Définissez le paramètre sur isPersistenttrue pour créer un ticket d’authentification qui dure au-delà de la session active.

Notes

Utilisez toujours le service d’authentification avec la couche ssl (Secure Sockets Layer, en utilisant HTTPS) pour protéger les données sensibles.

La Login méthode déclenche l’événement Authenticating et l’événement CreatingCookie . Créez un gestionnaire d’événements pour Authenticating personnaliser l’authentification, par exemple vérifier les valeurs dans customCredential ou valider les informations d’identification via un fournisseur d’appartenance non défini par défaut. Les valeurs dans customCredential ne sont pas validées par le fournisseur d’appartenances par défaut. Pour personnaliser le cookie d’authentification, créez un gestionnaire d’événements pour CreatingCookie.

Notes

N’appelez pas la Login méthode à partir du code qui s’exécute sur le serveur Web. Vous appelez la Login méthode uniquement dans le cadre d’un service WCF. Pour plus d’informations, consultez Authentification ASP.NET.

S’applique à

Voir aussi