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

Значение свойства IsOffline равно false, и поставщик членства не может получить доступ к службе проверки подлинности.

Примеры

В следующем примере кода показано, как использовать этот метод для проверки пользователя с помощью 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

Примеры

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

Универсальный код ресурса используемой службы проверки подлинности.

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

Boolean

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

Исключения

WebException

Примеры

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

Параметры

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

Исключения

Примеры

Комментарии

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

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

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

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