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
- Наследование
Примеры
В следующем примере кода показано, как использовать этот метод для проверки пользователя с помощью 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 класса .
После настройки можно проверить пользователей, вызвав static
Membership.ValidateUser метод , который внутренне вызывает ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) метод .
Для проверки подлинности с помощью форм требуется, чтобы пользователь указал свои учетные данные с помощью элементов управления для входа, предоставляемых приложением. Вы можете получить учетные данные и передать их в Membership.ValidateUser метод . Вы также можете передать пустые строки или null
использовать поставщик учетных данных. Поставщик учетных данных — это реализация, указанная IClientFormsAuthenticationCredentialsProvider в файле конфигурации приложения. Обычно этот метод реализуется IClientFormsAuthenticationCredentialsProvider.GetCredentials для отображения диалогового окна входа и возврата заполненного ClientFormsAuthenticationCredentials объекта. Использование поставщика учетных данных позволяет использовать одно диалоговое окно входа в разных приложениях.
Метод ClientFormsAuthenticationMembershipProvider.ValidateUser проверяет подлинность пользователей с помощью службы входа, указанной свойством ServiceUri . Значение ServiceUri свойства обычно извлекается из файла конфигурации приложения вместе с другими значениями конфигурации.
Если пользователь успешно прошел проверку подлинности, поставщик услуг присваивает свойству static
Thread.CurrentPrincipal новый ClientRolePrincipal объект, содержащий новый ClientFormsIdentity объект, содержащий сведения о пользователе. ClientRoleProvider Если для приложения настроен объект , можно использовать ClientRolePrincipal объект для получения сведений о роли пользователя из службы ролей.
Ссылку на текущий ClientFormsAuthenticationMembershipProvider экземпляр можно получить с помощью static
Membership.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) |
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по