AuthenticatingEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données pour l'événement Authenticating.
public ref class AuthenticatingEventArgs : EventArgs
public class AuthenticatingEventArgs : EventArgs
type AuthenticatingEventArgs = class
inherit EventArgs
Public Class AuthenticatingEventArgs
Inherits EventArgs
- Héritage
Exemples
L’exemple suivant montre un gestionnaire d’événements qui transmet les UserName valeurs et Password à un fournisseur d’appartenance personnalisé pour valider les informations d’identification de l’utilisateur. Le gestionnaire d’événements définit Authenticated sur la valeur de retour de la ValidateUser méthode et définit sur AuthenticationIsComplete pour true
que la AuthenticationService classe ne valide pas les informations d’identification.
void AuthenticationService_Authenticating(object sender, System.Web.ApplicationServices.AuthenticatingEventArgs e)
{
if (e.UserName.IndexOf("@contoso.com") >= 0)
{
e.Authenticated = Membership.Providers["ContosoSqlProvider"].ValidateUser(e.UserName, e.Password);
}
else if (e.UserName.IndexOf("@fabrikam.com") >= 0)
{
e.Authenticated = Membership.Providers["FabrikamSqlProvider"].ValidateUser(e.UserName, e.Password);
}
else
{
e.Authenticated = Membership.Provider.ValidateUser(e.UserName, e.Password);
}
e.AuthenticationIsComplete = true;
}
Sub AuthenticationService_Authenticating _
(ByVal sender As Object, _
ByVal e As System.Web.ApplicationServices.AuthenticatingEventArgs)
If (e.Username.IndexOf("@contoso.com") >= 0) Then
e.Authenticated = Membership.Providers("ContosoSqlProvider").ValidateUser(e.Username, e.Password)
ElseIf (e.Username.IndexOf("@fabrikam.com") >= 0) Then
e.Authenticated = Membership.Providers("FabrikamSqlProvider").ValidateUser(e.Username, e.Password)
Else
e.Authenticated = Membership.Provider.ValidateUser(e.Username, e.Password)
End If
e.AuthenticationIsComplete = True
End Sub
Remarques
Vous créez un gestionnaire pour l’événement Authenticating lorsque vous souhaitez personnaliser la façon dont les informations d’identification de l’utilisateur sont authentifiées au moment de l’exécution. La AuthenticatingEventArgs classe fournit des valeurs à n’importe quel Authenticating gestionnaire d’événements. En utilisant les propriétés disponibles dans cette classe, vous pouvez récupérer les informations d’identification de l’utilisateur pour personnaliser l’authentification.
La AuthenticationService classe déclenche l’événement Authenticating avant de valider les informations d’identification de l’utilisateur. La AuthenticationService classe construit une instance de l’objet et la AuthenticatingEventArgs transmet à n’importe quel Authenticating gestionnaire d’événements.
Vous pouvez utiliser les UserNamepropriétés et CustomCredentialPassword pour récupérer les informations d’identification de l’utilisateur. La CustomCredential propriété peut contenir des valeurs supplémentaires requises pour l’authentification, telles qu’un numéro d’identification.
La Authenticated propriété indique si les informations d’identification de l’utilisateur sont valides. Vous définissez la Authenticated propriété sur le résultat de votre authentification personnalisée. En outre, vous définissez la propriété true
sur AuthenticationIsComplete si vous avez vérifié les informations d’identification de l’utilisateur et que vous ne souhaitez pas que la AuthenticationService classe vérifie les informations d’identification de l’utilisateur via le fournisseur d’appartenance par défaut.
Propriétés
Authenticated |
Obtient ou définit une valeur qui indique si les informations d'identification de l'utilisateur sont valides. |
AuthenticationIsComplete |
Obtient ou définit une valeur qui indique si les informations d'identification de l'utilisateur ont été authentifiées. |
CustomCredential |
Obtient des valeurs d'utilisateur supplémentaires pour l'authentification. |
Password |
Obtient le mot de passe de l'utilisateur. |
UserName |
Obtient le nom d’authentification de l’utilisateur. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |