Partager via

ClientFormsAuthenticationMembershipProvider Classe

  • Référence

Définition

Espace de noms:
System.Web.ClientServices.Providers
Assembly:
System.Web.Extensions.dll

Active l’authentification par formulaire avec les services d’application cliente.

public ref class ClientFormsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider
public class ClientFormsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider
type ClientFormsAuthenticationMembershipProvider = class
    inherit MembershipProvider
Public Class ClientFormsAuthenticationMembershipProvider
Inherits MembershipProvider
Héritage
Object
ProviderBase
MembershipProvider
ClientFormsAuthenticationMembershipProvider

Exemples

L’exemple de code suivant montre comment utiliser cette méthode pour valider l’utilisateur à l’aide d’une implémentation IClientFormsAuthenticationCredentialsProvider.

private bool ValidateUsingCredentialsProvider()
{
    bool isAuthorized = false;
    try
    {
        ClientFormsAuthenticationMembershipProvider authProvider =
            System.Web.Security.Membership.Provider as
            ClientFormsAuthenticationMembershipProvider;

        // Call ValidateUser with empty strings in order to display the 
        // login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty);
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the authentication service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
    if (!isAuthorized)
    {
        MessageBox.Show("Unable to authenticate.", "Not logged in", 
            MessageBoxButtons.OK, MessageBoxIcon.Error);
        Application.Exit();
    }
    return isAuthorized;
}

Private Function ValidateUsingCredentialsProvider() As Boolean

    Dim isAuthorized As Boolean = False

    Try

        Dim authProvider As ClientFormsAuthenticationMembershipProvider = _
            CType(System.Web.Security.Membership.Provider,  _
            ClientFormsAuthenticationMembershipProvider)

        ' Call ValidateUser with empty strings in order to display the 
        ' login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty)

    Catch ex As System.Net.WebException

        MessageBox.Show("Unable to access the authentication service.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

    If Not isAuthorized Then

        MessageBox.Show("Unable to authenticate.", "Not logged in", _
            MessageBoxButtons.OK, MessageBoxIcon.Error)
        Application.Exit()

    End If

    Return isAuthorized

End Function

Remarques

Vous pouvez utiliser les services d’application cliente pour valider les utilisateurs à l’aide de l’authentification par formulaire. Pour activer l’authentification par formulaire, vous configurez votre application pour utiliser la classe ClientFormsAuthenticationMembershipProvider.

Après la configuration, vous pouvez valider les utilisateurs en appelant la méthode staticMembership.ValidateUser, qui appelle en interne la méthode ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String).

L’authentification par formulaire nécessite que l’utilisateur spécifie ses informations d’identification par le biais de contrôles de connexion fournis par votre application. Vous pouvez récupérer les informations d’identification et les transmettre à la méthode Membership.ValidateUser. Vous pouvez également transmettre des chaînes vides ou null pour utiliser un fournisseur d’informations d’identification. Un fournisseur d’informations d’identification est une implémentation IClientFormsAuthenticationCredentialsProvider spécifiée dans votre fichier de configuration d’application. Vous allez généralement implémenter la méthode IClientFormsAuthenticationCredentialsProvider.GetCredentials pour afficher une boîte de dialogue de connexion et retourner un objet ClientFormsAuthenticationCredentials rempli. L’utilisation d’un fournisseur d’informations d’identification vous permet de partager une boîte de dialogue de connexion unique entre plusieurs applications.

La méthode ClientFormsAuthenticationMembershipProvider.ValidateUser authentifie les utilisateurs via le service de connexion indiqué par la propriété ServiceUri. La valeur de la propriété ServiceUri est généralement récupérée à partir du fichier de configuration de l’application, ainsi que d’autres valeurs de configuration.

Si l’utilisateur est correctement authentifié, le fournisseur de services définit la propriété staticThread.CurrentPrincipal sur un nouvel objet ClientRolePrincipal qui contient un nouvel objet ClientFormsIdentity qui contient les informations de l’utilisateur. Si un ClientRoleProvider est configuré pour votre application, vous pouvez utiliser l’objet ClientRolePrincipal pour récupérer les informations de rôle utilisateur du service de rôles.

Vous pouvez récupérer une référence à l’instance de ClientFormsAuthenticationMembershipProvider actuelle via la propriété staticMembership.Provider. Vous pouvez utiliser la référence du fournisseur d’appartenances pour appeler directement la méthode ClientFormsAuthenticationMembershipProvider.ValidateUser. En outre, vous aurez besoin de la référence du fournisseur d’appartenances pour appeler la méthode Logout, qui n’est pas disponible dans la classe de base MembershipProvider.

Vous ne pouvez pas utiliser la classe ClientFormsAuthenticationMembershipProvider pour créer, supprimer ou modifier des informations d’appartenance. Pour créer, supprimer ou modifier des utilisateurs, vous devez modifier la configuration du service de connexion sur le serveur.

Constructeurs

ClientFormsAuthenticationMembershipProvider()

Initialise une nouvelle instance de la classe ClientFormsAuthenticationMembershipProvider.

Propriétés

ApplicationName

Cette propriété n’est pas utilisée par cette classe.
Description

Obtient une brève description conviviale adaptée à l’affichage dans les outils d’administration ou d’autres interfaces utilisateur (UIs).

(Hérité de ProviderBase)
EnablePasswordReset

Cette propriété n’est pas utilisée par cette classe.
EnablePasswordRetrieval

Cette propriété n’est pas utilisée par cette classe.
MaxInvalidPasswordAttempts

Cette propriété n’est pas utilisée par cette classe.
MinRequiredNonAlphanumericCharacters

Cette propriété n’est pas utilisée par cette classe.
MinRequiredPasswordLength

Cette propriété n’est pas utilisée par cette classe.
Name

Obtient le nom convivial utilisé pour faire référence au fournisseur pendant la configuration.

(Hérité de ProviderBase)
PasswordAttemptWindow

Cette propriété n’est pas utilisée par cette classe.
PasswordFormat

Cette propriété n’est pas utilisée par cette classe.
PasswordStrengthRegularExpression

Cette propriété n’est pas utilisée par cette classe.
RequiresQuestionAndAnswer

Cette propriété n’est pas utilisée par cette classe.
RequiresUniqueEmail

Cette propriété n’est pas utilisée par cette classe.
ServiceUri

Obtient ou définit l’URI du service d’authentification.

Méthodes

ChangePassword(String, String, String)

Cette méthode n’est pas utilisée par cette classe.
ChangePasswordQuestionAndAnswer(String, String, String, String)

Cette méthode n’est pas utilisée par cette classe.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

Cette méthode n’est pas utilisée par cette classe.
DecryptPassword(Byte[])

Déchiffre un mot de passe chiffré.

(Hérité de MembershipProvider)
DeleteUser(String, Boolean)

Cette méthode n’est pas utilisée par cette classe.
EncryptPassword(Byte[])

Chiffre un mot de passe.

(Hérité de MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Chiffre le mot de passe spécifié à l’aide du mode de compatibilité de mot de passe spécifié.

(Hérité de MembershipProvider)
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
FindUsersByEmail(String, Int32, Int32, Int32)

Cette méthode n’est pas utilisée par cette classe.
FindUsersByName(String, Int32, Int32, Int32)

Cette méthode n’est pas utilisée par cette classe.
GetAllUsers(Int32, Int32, Int32)

Cette méthode n’est pas utilisée par cette classe.
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetNumberOfUsersOnline()

Cette méthode n’est pas utilisée par cette classe.
GetPassword(String, String)

Cette méthode n’est pas utilisée par cette classe.
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
GetUser(Object, Boolean)

Cette méthode n’est pas utilisée par cette classe.
GetUser(String, Boolean)

Cette méthode n’est pas utilisée par cette classe.
GetUserNameByEmail(String)

Cette méthode n’est pas utilisée par cette classe.
Initialize(String, NameValueCollection)

Initialise le fournisseur.
Logout()

Déconnecte l’utilisateur.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
OnValidatingPassword(ValidatePasswordEventArgs)

Déclenche l’événement ValidatingPassword si un gestionnaire d’événements a été défini.

(Hérité de MembershipProvider)
ResetPassword(String, String)

Cette méthode n’est pas utilisée par cette classe.
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
UnlockUser(String)

Cette méthode n’est pas utilisée par cette classe.
UpdateUser(MembershipUser)

Cette méthode n’est pas utilisée par cette classe.
ValidateUser(String, String)

Authentifie un utilisateur à l’aide du nom d’utilisateur et du mot de passe spécifiés.
ValidateUser(String, String, Boolean)

Authentifie un utilisateur à l’aide du nom d’utilisateur et du mot de passe spécifiés, en stockant éventuellement un hachage du mot de passe dans le cache de données local.
ValidateUser(String, String, String)

Authentifie un utilisateur à l’URI de service spécifié à l’aide du nom d’utilisateur et du mot de passe spécifiés.

Événements

UserValidated

Se produit lorsque l’utilisateur est validé.
ValidatingPassword

Se produit lorsqu’un utilisateur est créé, qu’un mot de passe est modifié ou qu’un mot de passe est réinitialisé.

(Hérité de MembershipProvider)

S’applique à

Voir aussi