ClientFormsAuthenticationMembershipProvider Klasa

Definicja

Przestrzeń nazw:

System.Web.ClientServices.Providers

Zestaw:

System.Web.Extensions.dll

Umożliwia uwierzytelnianie formularzy za pomocą usług aplikacji klienckich.

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

Dziedziczenie

Object

ProviderBase

MembershipProvider

ClientFormsAuthenticationMembershipProvider

Przykłady

Poniższy przykładowy kod pokazuje, jak używać tej metody do weryfikowania użytkownika przy użyciu implementacji 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

Uwagi

Usługi aplikacji klienckich umożliwiają weryfikowanie użytkowników przy użyciu uwierzytelniania formularzy. Aby włączyć uwierzytelnianie formularzy, należy skonfigurować aplikację tak, aby korzystała z klasy ClientFormsAuthenticationMembershipProvider.

Po skonfigurowaniu można zweryfikować użytkowników, wywołując metodę staticMembership.ValidateUser, która wewnętrznie wywołuje metodę ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String).

Uwierzytelnianie formularzy wymaga, aby użytkownik określił swoje poświadczenia za pomocą kontrolek logowania udostępnianych przez aplikację. Możesz pobrać poświadczenia i przekazać je do metody Membership.ValidateUser. Możesz również przekazać puste ciągi lub null, aby użyć dostawcy poświadczeń. Dostawca poświadczeń to implementacja IClientFormsAuthenticationCredentialsProvider określona w pliku konfiguracji aplikacji. Zazwyczaj zaimplementujesz metodę IClientFormsAuthenticationCredentialsProvider.GetCredentials, aby wyświetlić okno dialogowe logowania i zwrócić wypełniony obiekt ClientFormsAuthenticationCredentials. Użycie dostawcy poświadczeń umożliwia udostępnianie jednego okna dialogowego logowania między wieloma aplikacjami.

Metoda ClientFormsAuthenticationMembershipProvider.ValidateUser uwierzytelnia użytkowników za pośrednictwem usługi logowania wskazanej przez właściwość ServiceUri. Wartość właściwości ServiceUri jest zwykle pobierana z pliku konfiguracji aplikacji wraz z innymi wartościami konfiguracji.

Jeśli użytkownik zostanie pomyślnie uwierzytelniony, dostawca usług ustawia właściwość staticThread.CurrentPrincipal na nowy obiekt ClientRolePrincipal zawierający nowy obiekt ClientFormsIdentity zawierający informacje o użytkowniku. Jeśli dla aplikacji skonfigurowano ClientRoleProvider, możesz użyć obiektu ClientRolePrincipal, aby pobrać informacje o roli użytkownika z usługi ról.

Odwołanie do bieżącego wystąpienia ClientFormsAuthenticationMembershipProvider można pobrać za pomocą właściwości staticMembership.Provider. Możesz użyć odwołania dostawcy członkostwa, aby wywołać metodę ClientFormsAuthenticationMembershipProvider.ValidateUser bezpośrednio. Ponadto należy odwołać się do dostawcy członkostwa, aby wywołać metodę Logout, która nie jest dostępna w MembershipProvider klasie bazowej.

Nie można użyć klasy ClientFormsAuthenticationMembershipProvider do tworzenia, usuwania ani modyfikowania informacji o członkostwie. Aby utworzyć, usunąć lub zmodyfikować użytkowników, musisz zmienić konfigurację usługi logowania na serwerze.

Konstruktory

ClientFormsAuthenticationMembershipProvider()

Inicjuje nowe wystąpienie klasy ClientFormsAuthenticationMembershipProvider.

Właściwości

ApplicationName	Ta właściwość nie jest używana przez tę klasę.
Description	Pobiera krótki, przyjazny opis odpowiedni do wyświetlania w narzędziach administracyjnych lub innych interfejsach użytkownika. (Odziedziczone po ProviderBase)
EnablePasswordReset	Ta właściwość nie jest używana przez tę klasę.
EnablePasswordRetrieval	Ta właściwość nie jest używana przez tę klasę.
MaxInvalidPasswordAttempts	Ta właściwość nie jest używana przez tę klasę.
MinRequiredNonAlphanumericCharacters	Ta właściwość nie jest używana przez tę klasę.
MinRequiredPasswordLength	Ta właściwość nie jest używana przez tę klasę.
Name	Pobiera przyjazną nazwę używaną do odwoływania się do dostawcy podczas konfiguracji. (Odziedziczone po ProviderBase)
PasswordAttemptWindow	Ta właściwość nie jest używana przez tę klasę.
PasswordFormat	Ta właściwość nie jest używana przez tę klasę.
PasswordStrengthRegularExpression	Ta właściwość nie jest używana przez tę klasę.
RequiresQuestionAndAnswer	Ta właściwość nie jest używana przez tę klasę.
RequiresUniqueEmail	Ta właściwość nie jest używana przez tę klasę.
ServiceUri	Pobiera lub ustawia identyfikator URI usługi uwierzytelniania.

Metody

ChangePassword(String, String, String)	Ta metoda nie jest używana przez tę klasę.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Ta metoda nie jest używana przez tę klasę.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Ta metoda nie jest używana przez tę klasę.
DecryptPassword(Byte[])	Odszyfrowuje zaszyfrowane hasło. (Odziedziczone po MembershipProvider)
DeleteUser(String, Boolean)	Ta metoda nie jest używana przez tę klasę.
EncryptPassword(Byte[])	Szyfruje hasło. (Odziedziczone po MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Szyfruje określone hasło przy użyciu określonego trybu zgodności haseł. (Odziedziczone po MembershipProvider)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Ta metoda nie jest używana przez tę klasę.
FindUsersByName(String, Int32, Int32, Int32)	Ta metoda nie jest używana przez tę klasę.
GetAllUsers(Int32, Int32, Int32)	Ta metoda nie jest używana przez tę klasę.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetNumberOfUsersOnline()	Ta metoda nie jest używana przez tę klasę.
GetPassword(String, String)	Ta metoda nie jest używana przez tę klasę.
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
GetUser(Object, Boolean)	Ta metoda nie jest używana przez tę klasę.
GetUser(String, Boolean)	Ta metoda nie jest używana przez tę klasę.
GetUserNameByEmail(String)	Ta metoda nie jest używana przez tę klasę.
Initialize(String, NameValueCollection)	Inicjuje dostawcę.
Logout()	Wyloguj użytkownika.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Zgłasza zdarzenie ValidatingPassword, jeśli zdefiniowano procedurę obsługi zdarzeń. (Odziedziczone po MembershipProvider)
ResetPassword(String, String)	Ta metoda nie jest używana przez tę klasę.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
UnlockUser(String)	Ta metoda nie jest używana przez tę klasę.
UpdateUser(MembershipUser)	Ta metoda nie jest używana przez tę klasę.
ValidateUser(String, String)	Uwierzytelnia użytkownika przy użyciu określonej nazwy użytkownika i hasła.
ValidateUser(String, String, Boolean)	Uwierzytelnia użytkownika przy użyciu określonej nazwy użytkownika i hasła, opcjonalnie przechowując skrót hasła w lokalnej pamięci podręcznej danych.
ValidateUser(String, String, String)	Uwierzytelnia użytkownika w określonym identyfikatorze URI usługi przy użyciu określonej nazwy użytkownika i hasła.

Zdarzenia

UserValidated	Występuje, gdy użytkownik jest weryfikowany.
ValidatingPassword	Występuje po utworzeniu użytkownika, zmianie hasła lub zresetowaniu hasła. (Odziedziczone po MembershipProvider)

Zobacz też

• ValidateUser
• ValidateUser(String, String)
• usług aplikacji klienckich
• Instrukcje: konfigurowanie usług aplikacji klienckich
• Instrukcje: implementowanie logowania użytkownika i wylogowywanie przy użyciu usług aplikacji klienckich