ClientFormsAuthenticationMembershipProvider Класс

Определение

Пространство имен:

System.Web.ClientServices.Providers

Сборка:

System.Web.Extensions.dll

Разрешает проверку подлинности с помощью форм, используя службы клиентского приложения.

public ref class ClientFormsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider

public class ClientFormsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider

type ClientFormsAuthenticationMembershipProvider = class
    inherit MembershipProvider

Public Class ClientFormsAuthenticationMembershipProvider
Inherits MembershipProvider

Наследование

Object

ProviderBase

MembershipProvider

ClientFormsAuthenticationMembershipProvider

Примеры

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

Комментарии

Службы клиентских приложений можно использовать для проверки пользователей с помощью проверки подлинности на основе форм. Чтобы включить проверку подлинности с помощью форм, настройте приложение для использования ClientFormsAuthenticationMembershipProvider класса .

После настройки можно проверить пользователей, вызвав staticMembership.ValidateUser метод , который внутренне вызывает ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) метод .

Для проверки подлинности с помощью форм требуется, чтобы пользователь указал свои учетные данные с помощью элементов управления для входа, предоставляемых приложением. Вы можете получить учетные данные и передать их в Membership.ValidateUser метод . Вы также можете передать пустые строки или null использовать поставщик учетных данных. Поставщик учетных данных — это реализация, указанная IClientFormsAuthenticationCredentialsProvider в файле конфигурации приложения. Обычно этот метод реализуется IClientFormsAuthenticationCredentialsProvider.GetCredentials для отображения диалогового окна входа и возврата заполненного ClientFormsAuthenticationCredentials объекта. Использование поставщика учетных данных позволяет использовать одно диалоговое окно входа в разных приложениях.

Метод ClientFormsAuthenticationMembershipProvider.ValidateUser проверяет подлинность пользователей с помощью службы входа, указанной свойством ServiceUri . Значение ServiceUri свойства обычно извлекается из файла конфигурации приложения вместе с другими значениями конфигурации.

Если пользователь успешно прошел проверку подлинности, поставщик услуг присваивает свойству staticThread.CurrentPrincipal новый ClientRolePrincipal объект, содержащий новый ClientFormsIdentity объект, содержащий сведения о пользователе. ClientRoleProvider Если для приложения настроен объект , можно использовать ClientRolePrincipal объект для получения сведений о роли пользователя из службы ролей.

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

Класс нельзя использовать ClientFormsAuthenticationMembershipProvider для создания, удаления или изменения сведений о членстве. Чтобы создать, удалить или изменить пользователей, необходимо изменить конфигурацию службы входа на сервере.

Конструкторы

ClientFormsAuthenticationMembershipProvider()

Инициализирует новый экземпляр класса ClientFormsAuthenticationMembershipProvider.

Свойства

ApplicationName	Это свойство не используется данным классом.
Description	Возвращает краткое, понятное описание, подходящее для отображения в инструментах администрирования или других пользовательских интерфейсах (UI). (Унаследовано от ProviderBase)
EnablePasswordReset	Это свойство не используется данным классом.
EnablePasswordRetrieval	Это свойство не используется данным классом.
MaxInvalidPasswordAttempts	Это свойство не используется данным классом.
MinRequiredNonAlphanumericCharacters	Это свойство не используется данным классом.
MinRequiredPasswordLength	Это свойство не используется данным классом.
Name	Возвращает понятное имя, используемое для ссылки на поставщика во время конфигурирования. (Унаследовано от ProviderBase)
PasswordAttemptWindow	Это свойство не используется данным классом.
PasswordFormat	Это свойство не используется данным классом.
PasswordStrengthRegularExpression	Это свойство не используется данным классом.
RequiresQuestionAndAnswer	Это свойство не используется данным классом.
RequiresUniqueEmail	Это свойство не используется данным классом.
ServiceUri	Возвращает или задает универсальный код ресурса (URI) службы проверки подлинности.

Методы

ChangePassword(String, String, String)	Этот метод не используется данным классом.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Этот метод не используется данным классом.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Этот метод не используется данным классом.
DecryptPassword(Byte[])	Расшифровывает зашифрованный пароль. (Унаследовано от MembershipProvider)
DeleteUser(String, Boolean)	Этот метод не используется данным классом.
EncryptPassword(Byte[])	Шифрует пароль. (Унаследовано от MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Шифрует заданный пароль с использованием заданного режима совместимости паролей. (Унаследовано от MembershipProvider)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Этот метод не используется данным классом.
FindUsersByName(String, Int32, Int32, Int32)	Этот метод не используется данным классом.
GetAllUsers(Int32, Int32, Int32)	Этот метод не используется данным классом.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetNumberOfUsersOnline()	Этот метод не используется данным классом.
GetPassword(String, String)	Этот метод не используется данным классом.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetUser(Object, Boolean)	Этот метод не используется данным классом.
GetUser(String, Boolean)	Этот метод не используется данным классом.
GetUserNameByEmail(String)	Этот метод не используется данным классом.
Initialize(String, NameValueCollection)	Инициализирует этот поставщик.
Logout()	Выполняет выход пользователя из системы.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Вызывает событие ValidatingPassword, если определен обработчик событий. (Унаследовано от MembershipProvider)
ResetPassword(String, String)	Этот метод не используется данным классом.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
UnlockUser(String)	Этот метод не используется данным классом.
UpdateUser(MembershipUser)	Этот метод не используется данным классом.
ValidateUser(String, String)	Выполняет проверку подлинности пользователя, используя заданные имя пользователя и пароль.
ValidateUser(String, String, Boolean)	Выполняет проверку подлинности пользователя, используя указанное имя пользователя и пароль, при необходимости сохраняя хэш пароля в локальном кэше данных.
ValidateUser(String, String, String)	Выполняет проверку подлинности пользователя по указанному URI службы, используя заданные имя пользователя и пароль.

События

UserValidated	Возникает при проверке пользователя.
ValidatingPassword	Происходит при создании пользователя, изменении пароля или сбросе пароля. (Унаследовано от MembershipProvider)

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

• ValidateUser
• ValidateUser(String, String)
• Службы клиентских приложений
• Практическое руководство. Настройка служб клиентских приложений
• Практическое руководство. Реализация входа и выхода пользователя с помощью служб клиентских приложений