ClientFormsAuthenticationMembershipProvider.ValidateUser Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Authentifie un utilisateur en utilisant les informations d'identification spécifiées.
Surcharges
ValidateUser(String, String) |
Authentifie un utilisateur en utilisant le nom d'utilisateur et mot de passe spécifiés. |
ValidateUser(String, String, Boolean) |
Authentifie un utilisateur en utilisant le nom d'utilisateur et mot de passe spécifiés, en stockant facultativement 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é en utilisant le nom d'utilisateur et mot de passe spécifiés. |
ValidateUser(String, String)
Authentifie un utilisateur en utilisant le nom d'utilisateur et 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 extraire des informations d'identification de l'implémentation IClientFormsAuthenticationCredentialsProvider que cette application est configurée à utiliser.
- password
- String
Le mot de passe de l'utilisateur à authentifier.
Retours
true
si l'utilisateur a été identifié ; sinon false
.
Exceptions
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 IClientFormsAuthenticationCredentialsProvider implémentation. Cet exemple vous oblige à configurer 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 static
Membership.ValidateUser méthode, qui appelle la ClientFormsAuthenticationMembershipProvider.ValidateUser méthode en interne. 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 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.
Voir aussi
- IClientFormsAuthenticationCredentialsProvider
- 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
S’applique à
ValidateUser(String, String, Boolean)
Authentifie un utilisateur en utilisant le nom d'utilisateur et mot de passe spécifiés, en stockant facultativement 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
Le mot de passe de l'utilisateur à authentifier.
- rememberMe
- Boolean
true
pour stocker un hachage du mot de passe dans le cache de données local pour une utilisation hors connexion et pour une réauthentification automatique lorsque le cookie d'authentification utilisateur expire ; false
pour désactiver l'ouverture de session hors connexion ou pour forcer les utilisateurs à se réauthentifier lorsque le cookie expire.
Retours
true
si l'utilisateur a été identifié ; sinon false
.
Exceptions
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 TextBox contrôle nommé usernameTextBox
, un TextBox contrôle nommé passwordTextBox
et un CheckBox contrôle 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 static
Membership.ValidateUser méthode, qui appelle la ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) méthode en interne. Vous pouvez également appeler la ClientFormsAuthenticationMembershipProvider.ValidateUser méthode directement. Vous pouvez appeler cette surcharge pour passer une rememberMe
valeur en plus des username
valeurs et password
.
Voir aussi
- 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
S’applique à
ValidateUser(String, String, String)
Authentifie un utilisateur à l'URI de service spécifié en utilisant le nom d'utilisateur et 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
Le mot de passe de l'utilisateur à authentifier.
- serviceUri
- String
URI du service d'authentification à utiliser.
Retours
true
si l'utilisateur a été identifié ; sinon false
.
Exceptions
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 des contrôles de connexion dans le code de votre application. Cet exemple nécessite un TextBox contrôle nommé usernameTextBox
et un TextBox contrôle 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 static
Membership.ValidateUser méthode, qui appelle la ClientFormsAuthenticationMembershipProvider.ValidateUser méthode en interne. Vous pouvez également appeler la ClientFormsAuthenticationMembershipProvider.ValidateUser méthode directement. Vous pouvez appeler cette surcharge pour accéder à un service d’authentification à l’emplacement spécifié par le serviceUri
paramètre. L’utilisation de cette surcharge est une alternative à la définition de la ServiceUri propriété et à l’appel de la ValidateUser(String, String) surcharge.
Voir aussi
- 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
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour