ClientFormsAuthenticationMembershipProvider Classe

Définition

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

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• ValidateUser
• ValidateUser(String, String)
• des services d’applications clientes
• Comment : configurer les services d’application cliente
• Comment : implémenter la connexion utilisateur et la déconnexion avec les services d’applications clientes