ClientFormsAuthenticationMembershipProvider.ValidateUser Метод

Ссылка

Определение

Пространство имен:: System.Web.ClientServices.Providers

Сборка:: System.Web.Extensions.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Проверяет подлинность пользователя с помощью указанных учетных данных.

Перегрузки

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

Пароль пользователя для проверки подлинности.

Возвращаемое значение

Boolean

true, если пользователь прошел проверку подлинности; в противном случае false.

Исключения

WebException

Значение свойства 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

Проверка подлинности форм требует, чтобы пользователь указал свои учетные данные с помощью элементов управления для входа, предоставляемых приложением. Вы можете получить учетные данные и передать их в метод 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.

Возвращаемое значение

Boolean

true, если пользователь прошел проверку подлинности; в противном случае false.

Исключения

WebException

Значение свойства 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) службы проверки подлинности для использования.

Возвращаемое значение

Boolean

true, если пользователь прошел проверку подлинности; в противном случае false.

Исключения

WebException

Значение свойства 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).

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

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

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

ClientFormsAuthenticationMembershipProvider.ValidateUser Метод

Определение

Перегрузки

ValidateUser(String, String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

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

ValidateUser(String, String, Boolean)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

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

ValidateUser(String, String, String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

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

Обратная связь

Дополнительные ресурсы