ClientFormsAuthenticationMembershipProvider.ValidateUser Méthode

Définition

Espace de noms:

System.Web.ClientServices.Providers

Assembly:

System.Web.Extensions.dll

Authentifie un utilisateur à l’aide des informations d’identification spécifiées.

Surcharges

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.

ValidateUser(String, String)

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

public:
 override bool ValidateUser(System::String ^ username, System::String ^ password);

public override bool ValidateUser (string username, string password);

override this.ValidateUser : string * string -> bool

Public Overrides Function ValidateUser (username As String, password As String) As Boolean

Paramètres

username

String

Nom de l’utilisateur à authentifier, ou Empty ou null pour récupérer les informations d’identification de l’implémentation IClientFormsAuthenticationCredentialsProvider que cette application est configurée pour l’utiliser.

password

String

Mot de passe de l’utilisateur à authentifier.

Retours

Boolean

true si l’utilisateur a été authentifié ; sinon, false.

Exceptions

WebException

La valeur de propriété IsOffline est false et le fournisseur d’appartenances ne peut pas accéder au service d’authentification.

Exemples

L’exemple de code suivant montre comment utiliser cette méthode pour valider l’utilisateur à l’aide d’une implémentation IClientFormsAuthenticationCredentialsProvider. Cet exemple nécessite que vous configuriez votre application pour utiliser un fournisseur d’informations d’identification.

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 valider les utilisateurs, vous appelez généralement la méthode staticMembership.ValidateUser, qui appelle en interne la méthode ClientFormsAuthenticationMembershipProvider.ValidateUser. Vous pouvez également appeler cette méthode directement, comme indiqué dans la section Exemple.

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.

Voir aussi

• IClientFormsAuthenticationCredentialsProvider
• 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

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.

public:
 bool ValidateUser(System::String ^ username, System::String ^ password, bool rememberMe);

public bool ValidateUser (string username, string password, bool rememberMe);

override this.ValidateUser : string * string * bool -> bool

Public Function ValidateUser (username As String, password As String, rememberMe As Boolean) As Boolean

Paramètres

username

String

Nom de l’utilisateur à authentifier.

password

String

Mot de passe de l’utilisateur à authentifier.

rememberMe

Boolean

true stocker un hachage du mot de passe dans le cache de données local pour une utilisation hors connexion et pour la réauthentification automatique lorsque le cookie d’authentification utilisateur expire ; false pour désactiver la connexion hors connexion ou demander aux utilisateurs de se réauthentifier à l’expiration du cookie.

Retours

Boolean

true si l’utilisateur a été authentifié ; sinon, false.

Exceptions

WebException

La valeur de propriété IsOffline est false et le fournisseur d’appartenances ne peut pas accéder au service d’authentification.

Exemples

L’exemple de code suivant montre comment utiliser cette méthode pour valider l’utilisateur à l’aide de contrôles de connexion dans le code de votre application. Cet exemple nécessite un contrôle TextBox nommé usernameTextBox, un contrôle TextBox nommé passwordTextBoxet un contrôle CheckBox nommé rememberMeCheckBox.

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

        // Call ValidateUser with credentials retrieved from login controls.
        isAuthorized = authProvider.ValidateUser(usernameTextBox.Text,
            passwordTextBox.Text, rememberMeCheckBox.Checked);
    }
    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 ValidateUsingLoginControls() As Boolean

    Dim isAuthorized As Boolean = False

    Try

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

        ' Call ValidateUser with credentials retrieved from login controls.
        isAuthorized = authProvider.ValidateUser(usernameTextBox.Text, _
            passwordTextBox.Text, rememberMeCheckBox.Checked)

    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 valider les utilisateurs, vous appelez généralement la méthode staticMembership.ValidateUser, qui appelle en interne la méthode ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String). Vous pouvez également appeler directement la méthode ClientFormsAuthenticationMembershipProvider.ValidateUser. Vous pouvez appeler cette surcharge pour passer une valeur rememberMe en plus des valeurs username et password.

Voir aussi

• 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

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.

public:
 static bool ValidateUser(System::String ^ username, System::String ^ password, System::String ^ serviceUri);

public static bool ValidateUser (string username, string password, string serviceUri);

static member ValidateUser : string * string * string -> bool

Public Shared Function ValidateUser (username As String, password As String, serviceUri As String) As Boolean

Paramètres

username

String

Nom de l’utilisateur à authentifier.

password

String

Mot de passe de l’utilisateur à authentifier.

serviceUri

String

URI du service d’authentification à utiliser.

Retours

Boolean

true si l’utilisateur a été authentifié ; sinon, false.

Exceptions

WebException

La valeur de propriété IsOffline est false et le fournisseur d’appartenances ne peut pas accéder au service d’authentification.

Exemples

L’exemple de code suivant montre comment utiliser cette méthode pour valider l’utilisateur via un service d’authentification à un emplacement spécifié. Les informations d’identification de l’utilisateur sont récupérées à partir de contrôles de connexion dans le code de votre application. Cet exemple nécessite un contrôle TextBox nommé usernameTextBox et un contrôle TextBox nommé passwordTextBox.

private bool ValidateUsingServiceUri(String serviceUri)
{
    bool isAuthorized = false;
    try
    {
        // Call the static overload of ValidateUser. Specify credentials 
        // retrieved from login controls and the service location.
        isAuthorized = 
            ClientFormsAuthenticationMembershipProvider.ValidateUser(
            usernameTextBox.Text, passwordTextBox.Text, serviceUri);
    }
    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 ValidateUsingServiceUri(ByVal serviceUri As String) As Boolean

    Dim isAuthorized As Boolean = False

    Try

        ' Call the Shared overload of ValidateUser. Specify credentials 
        ' retrieved from login controls and the service location.
        isAuthorized = _
            ClientFormsAuthenticationMembershipProvider.ValidateUser( _
            usernameTextBox.Text, passwordTextBox.Text, serviceUri)

    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 valider les utilisateurs, vous appelez généralement la méthode staticMembership.ValidateUser, qui appelle en interne la méthode ClientFormsAuthenticationMembershipProvider.ValidateUser. Vous pouvez également appeler directement la méthode ClientFormsAuthenticationMembershipProvider.ValidateUser. Vous pouvez appeler cette surcharge pour accéder à un service d’authentification à l’emplacement spécifié par le paramètre serviceUri. L’utilisation de cette surcharge est une alternative à la définition de la propriété ServiceUri et à l’appel de la surcharge ValidateUser(String, String).

Voir aussi

• 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