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’appartenance. Vous pouvez utiliser le fournisseur d’appartenance par défaut ou spécifier un fournisseur d’appartenance personnalisé au moment de l’exécution. La AuthenticationService classe passe userName et password à la méthode du ValidateUser fournisseur d’appartenance, mais ne réussit customCredentialpas . Si ValidateUser retourne true, AuthenticationService crée un ticket d’authentification en tant que cookie. Définissez le isPersistent paramètre sur true pour créer un ticket d’authentification qui dure au-delà de la session actuelle.

Notes

Utilisez toujours le service d’authentification avec la couche de sockets sécurisés (SSL, à l’aide du protocole 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 pour Authenticating personnaliser l’authentification, comme la vérification des valeurs dans customCredential ou la validation des informations d’identification via un fournisseur d’appartenance autre que par défaut. Les valeurs dans customCredential ne sont pas validées par le fournisseur d’appartenance 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 méthode uniquement dans le Login cadre d’un service WCF. Pour plus d’informations, consultez Authentification ASP.NET.

S’applique à

Voir aussi