ClientFormsAuthenticationMembershipProvider.ValidateUser Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Проверяет подлинность пользователя с помощью указанных учетных данных.
Перегрузки
ValidateUser(String, String) |
Выполняет проверку подлинности пользователя с помощью указанного имени пользователя и пароля. |
ValidateUser(String, String, Boolean) |
Проверяет подлинность пользователя с помощью указанного имени пользователя и пароля, при необходимости сохраняя хэш пароля в локальном кэше данных. |
ValidateUser(String, String, String) |
Проверяет подлинность пользователя в указанном URI службы с помощью указанного имени пользователя и пароля. |
ValidateUser(String, String)
Выполняет проверку подлинности пользователя с помощью указанного имени пользователя и пароля.
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
Параметры
- username
- String
Имя пользователя для проверки подлинности или Empty или null
для получения учетных данных из реализации IClientFormsAuthenticationCredentialsProvider, которую настроено для использования приложением.
- password
- String
Пароль пользователя для проверки подлинности.
Возвращаемое значение
true
, если пользователь прошел проверку подлинности; в противном случае false
.
Исключения
Значение свойства IsOfflinefalse
, и поставщик членства не может получить доступ к службе проверки подлинности.
Примеры
В следующем примере кода показано, как использовать этот метод для проверки пользователя с помощью реализации 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
Комментарии
Службы клиентских приложений можно использовать для проверки пользователей с помощью проверки подлинности форм. Для проверки пользователей обычно вызывается метод static
Membership.ValidateUser, который внутренне вызывает метод ClientFormsAuthenticationMembershipProvider.ValidateUser. Кроме того, этот метод можно вызвать напрямую, как показано в разделе "Пример".
Проверка подлинности форм требует, чтобы пользователь указал свои учетные данные с помощью элементов управления для входа, предоставляемых приложением. Вы можете получить учетные данные и передать их в метод Membership.ValidateUser. Вы также можете передать пустые строки или null
для использования поставщика учетных данных.
См. также раздел
- IClientFormsAuthenticationCredentialsProvider
- ValidateUser(String, String)
- клиентских служб приложений
- Практическое руководство. Настройка служб клиентских приложений
- Практическое руководство. Реализация входа пользователя и выхода с помощью клиентских служб приложений
Применяется к
ValidateUser(String, String, Boolean)
Проверяет подлинность пользователя с помощью указанного имени пользователя и пароля, при необходимости сохраняя хэш пароля в локальном кэше данных.
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
Параметры
- username
- String
Имя пользователя для проверки подлинности.
- password
- String
Пароль пользователя для проверки подлинности.
- rememberMe
- Boolean
true
хранить хэш пароля в локальном кэше данных для автономного использования и автоматической повторной проверки подлинности при истечении срока действия файла cookie проверки подлинности пользователя; false
отключить автономное имя входа или требовать повторной проверки подлинности пользователей при истечении срока действия файла cookie.
Возвращаемое значение
true
, если пользователь прошел проверку подлинности; в противном случае false
.
Исключения
Значение свойства IsOfflinefalse
, и поставщик членства не может получить доступ к службе проверки подлинности.
Примеры
В следующем примере кода показано, как использовать этот метод для проверки пользователя с помощью элементов управления входа в коде приложения. В этом примере требуется элемент управления TextBox с именем usernameTextBox
, элемент управления TextBox с именем passwordTextBox
и элемент управления CheckBox с именем 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
Комментарии
Службы клиентских приложений можно использовать для проверки пользователей с помощью проверки подлинности форм. Для проверки пользователей обычно вызывается метод static
Membership.ValidateUser, который внутренне вызывает метод ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String). Кроме того, можно напрямую вызвать метод ClientFormsAuthenticationMembershipProvider.ValidateUser. Эту перегрузку можно вызвать для передачи значения rememberMe
в дополнение к значениям username
и password
.
См. также раздел
- ValidateUser(String, String)
- клиентских служб приложений
- Практическое руководство. Настройка служб клиентских приложений
- Практическое руководство. Реализация входа пользователя и выхода с помощью клиентских служб приложений
Применяется к
ValidateUser(String, String, String)
Проверяет подлинность пользователя в указанном URI службы с помощью указанного имени пользователя и пароля.
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
Параметры
- username
- String
Имя пользователя для проверки подлинности.
- password
- String
Пароль пользователя для проверки подлинности.
- serviceUri
- String
Универсальный код ресурса (URI) службы проверки подлинности для использования.
Возвращаемое значение
true
, если пользователь прошел проверку подлинности; в противном случае false
.
Исключения
Значение свойства IsOfflinefalse
, и поставщик членства не может получить доступ к службе проверки подлинности.
Примеры
В следующем примере кода показано, как использовать этот метод для проверки пользователя с помощью службы проверки подлинности в указанном расположении. Учетные данные пользователя извлекаются из элементов управления входа в коде приложения. В этом примере требуется элемент управления TextBox с именем usernameTextBox
и элемент управления TextBox с именем 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
Комментарии
Службы клиентских приложений можно использовать для проверки пользователей с помощью проверки подлинности форм. Для проверки пользователей обычно вызывается метод static
Membership.ValidateUser, который внутренне вызывает метод ClientFormsAuthenticationMembershipProvider.ValidateUser. Кроме того, можно напрямую вызвать метод ClientFormsAuthenticationMembershipProvider.ValidateUser. Эту перегрузку можно вызвать для доступа к службе проверки подлинности в расположении, указанном параметром serviceUri
. Использование этой перегрузки является альтернативой настройке свойства ServiceUri и вызову перегрузки ValidateUser(String, String).
См. также раздел
- ValidateUser(String, String)
- клиентских служб приложений
- Практическое руководство. Настройка служб клиентских приложений
- Практическое руководство. Реализация входа пользователя и выхода с помощью клиентских служб приложений