AuthenticatingEventArgs Classe

Définition

Fournit des données pour l'événement Authenticating.Provides data for the Authenticating event.

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.The following example shows an event handler that passes the UserName and Password values to a custom membership provider to validate the user credentials. 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.The event handler sets Authenticated to the return value of the ValidateUser method and sets AuthenticationIsComplete to true so that the AuthenticationService class does not validate the credentials.

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.You create a handler for the Authenticating event when you want to customize how the user's credentials are authenticated at run time. La AuthenticatingEventArgs classe fournit des valeurs à n’importe quel Authenticating Gestionnaire d’événements.The AuthenticatingEventArgs class supplies values to any Authenticating event handler. À 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.By using the properties available in this class, you can retrieve the user credentials to customize authentication.

La AuthenticationService classe déclenche l' Authenticating événement avant de valider les informations d’identification de l’utilisateur.The AuthenticationService class raises the Authenticating event before validating the user credentials. La AuthenticationService classe construit une instance de l' AuthenticatingEventArgs objet et la passe à n’importe quel Authenticating Gestionnaire d’événements.The AuthenticationService class constructs an instance of the AuthenticatingEventArgs object and passes it to any Authenticating event handler.

Vous pouvez utiliser les UserName Password Propriétés, et CustomCredential pour récupérer les informations d’identification de l’utilisateur.You can use the UserName, Password and CustomCredential properties to retrieve the user credentials. La CustomCredential propriété peut contenir des valeurs supplémentaires qui sont requises pour l’authentification, telles qu’un numéro d’identification.The CustomCredential property can contain additional values that are required for authentication, such as an identification number.

La Authenticated propriété indique si les informations d’identification de l’utilisateur sont valides.The Authenticated property indicates whether the user credentials are valid. Vous définissez la Authenticated propriété sur le résultat de votre authentification personnalisée.You set the Authenticated property to the result of your customized authentication. 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.In addition, you set the AuthenticationIsComplete property to true if you have checked the user credentials and do not want the AuthenticationService class to check user credentials through the default membership provider.

Propriétés

Authenticated

Obtient ou définit une valeur qui indique si les informations d'identification de l'utilisateur sont valides.Gets or sets a value that indicates whether the user credentials are valid.

AuthenticationIsComplete

Obtient ou définit une valeur qui indique si les informations d'identification de l'utilisateur ont été authentifiées.Gets or sets a value that indicates whether the user credentials have been authenticated.

CustomCredential

Obtient des valeurs d'utilisateur supplémentaires pour l'authentification.Gets additional user values for authentication.

Password

Obtient le mot de passe de l'utilisateur.Gets the password for the user.

UserName

Obtient le nom d’authentification de l’utilisateur.Gets the authentication name for the user.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

S’applique à