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 для создания, удаления или изменения сведений о членстве. Чтобы создать, удалить или изменить пользователей, необходимо изменить конфигурацию службы входа на сервере.
Client |
Инициализирует новый экземпляр класса ClientFormsAuthenticationMembershipProvider. |
Application |
Это свойство не используется этим классом. |
Description |
Получает краткое понятное описание, подходящее для отображения в средствах администрирования или других пользовательских интерфейсах (UIs). (Унаследовано от ProviderBase) |
Enable |
Это свойство не используется этим классом. |
Enable |
Это свойство не используется этим классом. |
Max |
Это свойство не используется этим классом. |
Min |
Это свойство не используется этим классом. |
Min |
Это свойство не используется этим классом. |
Name |
Возвращает понятное имя, используемое для ссылки на поставщика во время настройки. (Унаследовано от ProviderBase) |
Password |
Это свойство не используется этим классом. |
Password |
Это свойство не используется этим классом. |
Password |
Это свойство не используется этим классом. |
Requires |
Это свойство не используется этим классом. |
Requires |
Это свойство не используется этим классом. |
Service |
Возвращает или задает универсальный код ресурса (URI) службы проверки подлинности. |
Change |
Этот метод не используется этим классом. |
Change |
Этот метод не используется этим классом. |
Create |
Этот метод не используется этим классом. |
Decrypt |
Расшифровывает зашифрованный пароль. (Унаследовано от MembershipProvider) |
Delete |
Этот метод не используется этим классом. |
Encrypt |
Шифрует пароль. (Унаследовано от MembershipProvider) |
Encrypt |
Шифрует указанный пароль с помощью указанного режима совместимости паролей. (Унаследовано от MembershipProvider) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
Find |
Этот метод не используется этим классом. |
Find |
Этот метод не используется этим классом. |
Get |
Этот метод не используется этим классом. |
Get |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
Get |
Этот метод не используется этим классом. |
Get |
Этот метод не используется этим классом. |
Get |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
Get |
Этот метод не используется этим классом. |
Get |
Этот метод не используется этим классом. |
Get |
Этот метод не используется этим классом. |
Initialize(String, Name |
Инициализирует поставщика. |
Logout() |
Выходит из системы пользователя. |
Memberwise |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
On |
Вызывает событие ValidatingPassword, если был определен обработчик событий. (Унаследовано от MembershipProvider) |
Reset |
Этот метод не используется этим классом. |
To |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Unlock |
Этот метод не используется этим классом. |
Update |
Этот метод не используется этим классом. |
Validate |
Выполняет проверку подлинности пользователя с помощью указанного имени пользователя и пароля. |
Validate |
Проверяет подлинность пользователя с помощью указанного имени пользователя и пароля, при необходимости сохраняя хэш пароля в локальном кэше данных. |
Validate |
Проверяет подлинность пользователя в указанном URI службы с помощью указанного имени пользователя и пароля. |
User |
Происходит при проверке пользователя. |
Validating |
Происходит при создании пользователя, изменении пароля или сбросе пароля. (Унаследовано от MembershipProvider) |
Продукт | Версии |
---|---|
.NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: