Поделиться через


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

Комментарии

Службы клиентских приложений можно использовать для проверки пользователей с помощью проверки подлинности форм. Для проверки пользователей обычно вызывается метод staticMembership.ValidateUser, который внутренне вызывает метод ClientFormsAuthenticationMembershipProvider.ValidateUser. Кроме того, этот метод можно вызвать напрямую, как показано в разделе "Пример".

Проверка подлинности форм требует, чтобы пользователь указал свои учетные данные с помощью элементов управления для входа, предоставляемых приложением. Вы можете получить учетные данные и передать их в метод Membership.ValidateUser. Вы также можете передать пустые строки или null для использования поставщика учетных данных.

См. также раздел

Применяется к

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

Комментарии

Службы клиентских приложений можно использовать для проверки пользователей с помощью проверки подлинности форм. Для проверки пользователей обычно вызывается метод staticMembership.ValidateUser, который внутренне вызывает метод ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String). Кроме того, можно напрямую вызвать метод ClientFormsAuthenticationMembershipProvider.ValidateUser. Эту перегрузку можно вызвать для передачи значения rememberMe в дополнение к значениям username и password.

См. также раздел

Применяется к

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

Комментарии

Службы клиентских приложений можно использовать для проверки пользователей с помощью проверки подлинности форм. Для проверки пользователей обычно вызывается метод staticMembership.ValidateUser, который внутренне вызывает метод ClientFormsAuthenticationMembershipProvider.ValidateUser. Кроме того, можно напрямую вызвать метод ClientFormsAuthenticationMembershipProvider.ValidateUser. Эту перегрузку можно вызвать для доступа к службе проверки подлинности в расположении, указанном параметром serviceUri. Использование этой перегрузки является альтернативой настройке свойства ServiceUri и вызову перегрузки ValidateUser(String, String).

См. также раздел

Применяется к