ClientFormsAuthenticationMembershipProvider Třída

Definice

Obor názvů:

System.Web.ClientServices.Providers

Sestavení:

System.Web.Extensions.dll

Povolí ověřování pomocí formulářů pomocí klientských aplikačních služeb.

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

Dědičnost

Object

ProviderBase

MembershipProvider

ClientFormsAuthenticationMembershipProvider

Příklady

Následující příklad kódu ukazuje, jak použít tuto metodu k ověření uživatele pomocí IClientFormsAuthenticationCredentialsProvider implementace.

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

Poznámky

Pomocí klientských aplikačních služeb můžete ověřovat uživatele pomocí ověřování pomocí formulářů. Pokud chcete povolit ověřování pomocí formulářů, nakonfigurujte aplikaci tak, aby používala třídu ClientFormsAuthenticationMembershipProvider.

Po konfiguraci můžete ověřit uživatele voláním metody staticMembership.ValidateUser, která interně volá metodu ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String).

Ověřování pomocí formulářů vyžaduje, aby uživatel zadal své přihlašovací údaje prostřednictvím přihlašovacích ovládacích prvků poskytovaných vaší aplikací. Přihlašovací údaje můžete načíst a předat je metodě Membership.ValidateUser. Můžete také předat prázdné řetězce nebo null použít zprostředkovatele přihlašovacích údajů. Zprostředkovatel přihlašovacích údajů je IClientFormsAuthenticationCredentialsProvider implementace zadaná v konfiguračním souboru aplikace. Obvykle implementujete metodu IClientFormsAuthenticationCredentialsProvider.GetCredentials pro zobrazení přihlašovacího dialogového okna a vrácení vyplněného ClientFormsAuthenticationCredentials objektu. Použití zprostředkovatele přihlašovacích údajů umožňuje sdílet jedno přihlašovací dialogové okno mezi více aplikacemi.

Metoda ClientFormsAuthenticationMembershipProvider.ValidateUser ověřuje uživatele prostřednictvím přihlašovací služby označené vlastností ServiceUri. Hodnota vlastnosti ServiceUri se obvykle načte z konfiguračního souboru aplikace spolu s dalšími hodnotami konfigurace.

Pokud je uživatel úspěšně ověřen, poskytovatel služeb nastaví vlastnost staticThread.CurrentPrincipal na nový objekt ClientRolePrincipal, který obsahuje nový objekt ClientFormsIdentity obsahující informace o uživateli. Pokud je pro vaši aplikaci nakonfigurovaný ClientRoleProvider, můžete pomocí objektu ClientRolePrincipal načíst informace o rolích uživatele ze služby rolí.

Odkaz na aktuální instanci ClientFormsAuthenticationMembershipProvider můžete načíst prostřednictvím vlastnosti staticMembership.Provider. Odkaz na zprostředkovatele členství můžete použít k přímému volání metody ClientFormsAuthenticationMembershipProvider.ValidateUser. Kromě toho budete potřebovat odkaz zprostředkovatele členství volat Logout metodu, která není k dispozici v MembershipProvider základní třídě.

Třídu ClientFormsAuthenticationMembershipProvider nelze použít k vytvoření, odstranění nebo úpravě informací o členství. Pokud chcete vytvářet, odstraňovat nebo upravovat uživatele, musíte změnit konfiguraci přihlašovací služby na serveru.

Konstruktory

ClientFormsAuthenticationMembershipProvider()

Inicializuje novou instanci ClientFormsAuthenticationMembershipProvider třídy.

Vlastnosti

ApplicationName	Tato vlastnost není používána touto třídou.
Description	Získá stručný popis vhodný pro zobrazení v nástrojích pro správu nebo jiných uživatelských rozhraních (UI). (Zděděno od ProviderBase)
EnablePasswordReset	Tato vlastnost není používána touto třídou.
EnablePasswordRetrieval	Tato vlastnost není používána touto třídou.
MaxInvalidPasswordAttempts	Tato vlastnost není používána touto třídou.
MinRequiredNonAlphanumericCharacters	Tato vlastnost není používána touto třídou.
MinRequiredPasswordLength	Tato vlastnost není používána touto třídou.
Name	Získá popisný název použitý k odkazování na zprostředkovatele během konfigurace. (Zděděno od ProviderBase)
PasswordAttemptWindow	Tato vlastnost není používána touto třídou.
PasswordFormat	Tato vlastnost není používána touto třídou.
PasswordStrengthRegularExpression	Tato vlastnost není používána touto třídou.
RequiresQuestionAndAnswer	Tato vlastnost není používána touto třídou.
RequiresUniqueEmail	Tato vlastnost není používána touto třídou.
ServiceUri	Získá nebo nastaví identifikátor URI ověřovací služby.

Metody

ChangePassword(String, String, String)	Tato metoda není používána touto třídou.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Tato metoda není používána touto třídou.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Tato metoda není používána touto třídou.
DecryptPassword(Byte[])	Dešifruje šifrované heslo. (Zděděno od MembershipProvider)
DeleteUser(String, Boolean)	Tato metoda není používána touto třídou.
EncryptPassword(Byte[])	Zašifruje heslo. (Zděděno od MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Zašifruje zadané heslo pomocí zadaného režimu kompatibility s heslem. (Zděděno od MembershipProvider)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Tato metoda není používána touto třídou.
FindUsersByName(String, Int32, Int32, Int32)	Tato metoda není používána touto třídou.
GetAllUsers(Int32, Int32, Int32)	Tato metoda není používána touto třídou.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetNumberOfUsersOnline()	Tato metoda není používána touto třídou.
GetPassword(String, String)	Tato metoda není používána touto třídou.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetUser(Object, Boolean)	Tato metoda není používána touto třídou.
GetUser(String, Boolean)	Tato metoda není používána touto třídou.
GetUserNameByEmail(String)	Tato metoda není používána touto třídou.
Initialize(String, NameValueCollection)	Inicializuje poskytovatele.
Logout()	Odhlásí uživatele.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Vyvolá událost ValidatingPassword, pokud byla definována obslužná rutina události. (Zděděno od MembershipProvider)
ResetPassword(String, String)	Tato metoda není používána touto třídou.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
UnlockUser(String)	Tato metoda není používána touto třídou.
UpdateUser(MembershipUser)	Tato metoda není používána touto třídou.
ValidateUser(String, String)	Ověřuje uživatele pomocí zadaného uživatelského jména a hesla.
ValidateUser(String, String, Boolean)	Ověřuje uživatele pomocí zadaného uživatelského jména a hesla, volitelně uloží hodnotu hash hesla do místní mezipaměti dat.
ValidateUser(String, String, String)	Ověřuje uživatele na zadaném identifikátoru URI služby pomocí zadaného uživatelského jména a hesla.

Událost

UserValidated	Nastane, když je uživatel ověřen.
ValidatingPassword	Nastane při vytvoření uživatele, změně hesla nebo resetování hesla. (Zděděno od MembershipProvider)

Viz také

• ValidateUser
• ValidateUser(String, String)
• klientských aplikačních služeb
• Postupy: Konfigurace klientských aplikačních služeb
• Postupy: Implementace přihlášení uživatele a odhlášení pomocí klientských aplikačních služeb