AuthenticatingEventArgs Classe

Définition

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
AuthenticatingEventArgs

Exemples

L’exemple suivant montre un gestionnaire d’événements qui passe UserName les Password valeurs et à un fournisseur d’appartenances personnalisé pour valider les informations d’identification de l’utilisateur. Le gestionnaire d’événements affecte Authenticated à la valeur de retour de la ValidateUser méthode et définit AuthenticationIsComplete à true afin 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' Authenticating événement 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. À l’aide des 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' Authenticating événement avant de valider les informations d’identification de l’utilisateur. La AuthenticationService classe construit une instance de l' AuthenticatingEventArgs objet et la passe à n’importe quel Authenticating Gestionnaire d’événements.

Vous pouvez utiliser les UserName Password Propriétés, et CustomCredential pour récupérer les informations d’identification de l’utilisateur. La CustomCredential propriété peut contenir des valeurs supplémentaires qui sont 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 affectez AuthenticationIsComplete à la propriété la valeur true 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’appartenances 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)

S’applique à

Voir aussi