ClientFormsAuthenticationMembershipProvider Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.ClientServices.Providers

Zestaw:: System.Web.Extensions.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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ę do używania ClientFormsAuthenticationMembershipProvider klasy .

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 dostarczonych przez aplikację. Możesz pobrać poświadczenia i przekazać je do Membership.ValidateUser metody . Możesz również przekazać puste ciągi lub null użyć dostawcy poświadczeń. Dostawca poświadczeń to implementacja określona IClientFormsAuthenticationCredentialsProvider w pliku konfiguracji aplikacji. Zazwyczaj zaimplementujesz metodę IClientFormsAuthenticationCredentialsProvider.GetCredentials w celu wyświetlenia okna dialogowego logowania i zwrócenia wypełnionego ClientFormsAuthenticationCredentials obiektu. 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 ServiceUri przez właściwość . Wartość ServiceUri właściwości jest zwykle pobierana z pliku konfiguracji aplikacji wraz z innymi wartościami konfiguracji.

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

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

Nie można użyć ClientFormsAuthenticationMembershipProvider klasy 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 (UI). (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 dany obiekt jest taki sam, jak bieżący obiekt. (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()	Type Pobiera wartość 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()	Wyloguje użytkownika.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (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)

Dotyczy