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

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

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 для создания, удаления или изменения сведений о членстве. Чтобы создать, удалить или изменить пользователей, необходимо изменить конфигурацию службы входа на сервере.

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

Свойства

Методы

События

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

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

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