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


ClientFormsAuthenticationMembershipProvider Класс

Определение

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

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
Наследование
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)

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

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