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 IClientFormsAuthenticationCredentialsProvider implémentation.

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 ClientFormsAuthenticationMembershipProvider classe .

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

L’authentification par formulaire nécessite que l’utilisateur spécifie ses informations d’identification via des contrôles de connexion fournis par votre application. Vous pouvez récupérer les informations d’identification et les passer à la Membership.ValidateUser méthode . Vous pouvez également transmettre des chaînes vides ou null utiliser un fournisseur d’informations d’identification. Un fournisseur d’informations d’identification est une IClientFormsAuthenticationCredentialsProvider implémentation spécifiée dans votre fichier de configuration d’application. Vous allez généralement implémenter la IClientFormsAuthenticationCredentialsProvider.GetCredentials méthode pour afficher une boîte de dialogue de connexion et retourner un objet rempli ClientFormsAuthenticationCredentials . 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 ClientFormsAuthenticationMembershipProvider.ValidateUser méthode authentifie les utilisateurs via le service de connexion indiqué par la ServiceUri propriété . La valeur de la ServiceUri propriété est généralement récupérée à partir du fichier de configuration de l’application avec d’autres valeurs de configuration.

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

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

Vous ne pouvez pas utiliser la ClientFormsAuthenticationMembershipProvider classe 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)
• Services d'application cliente
• Comment : configurer les services d'application cliente
• Procédure : implémenter la connexion utilisateur et la déconnexion avec les services d’application client