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

S’applique à

Voir aussi