ClientFormsAuthenticationMembershipProvider Třída

Definice

Obor názvů:

System.Web.ClientServices.Providers

Sestavení:

System.Web.Extensions.dll

Umožňuje ověřování pomocí formulářů s klientskými aplikačními službami.

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

Služby klientských aplikací můžete použít k ověřování uživatelů pomocí ověřování pomocí formulářů. Pokud chcete povolit ověřování pomocí formulářů, nakonfigurujte aplikaci tak, aby používala ClientFormsAuthenticationMembershipProvider třídu .

Po dokončení konfigurace můžete uživatele ověřit 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 ovládacích prvků pro přihlášení 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 poskytovatele přihlašovacích údajů. Zprostředkovatel přihlašovacích údajů je implementace zadaná v konfiguračním IClientFormsAuthenticationCredentialsProvider souboru aplikace. Obvykle implementujete metodu IClientFormsAuthenticationCredentialsProvider.GetCredentials pro zobrazení dialogového okna přihlášení a vrácení naplněného ClientFormsAuthenticationCredentials objektu. Použití poskytovatele přihlašovacích údajů umožňuje sdílet jedno dialogové okno přihlášení mezi více aplikacemi.

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

Pokud je uživatel úspěšně ověřen, poskytovatel služeb nastaví staticThread.CurrentPrincipal vlastnost na nový ClientRolePrincipal objekt, který obsahuje nový ClientFormsIdentity objekt, který obsahuje informace o uživateli. ClientRoleProvider Pokud je pro vaši aplikaci nakonfigurovaný objekt , můžete ho ClientRolePrincipal použít k načtení informací o roli uživatele ze služby rolí.

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

Třídu nelze použít ClientFormsAuthenticationMembershipProvider 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í (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 odkaz 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 hesla. (Zděděno od MembershipProvider)
Equals(Object)	Určí, zda se zadaný objekt rovná 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í hashovací funkce. (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()	Type Získá z 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 zprostředkovatele.
Logout()	Odhlásí uživatele.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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 a volitelně uloží hodnotu hash hesla do místní mezipaměti dat.
ValidateUser(String, String, String)	Ověří uživatele na zadaném identifikátoru URI služby pomocí zadaného uživatelského jména a hesla.

Událost

UserValidated	Vyvolá se při ověření uživatele.
ValidatingPassword	Vyvolá se 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é aplikační služby
• Postupy: Konfigurace klientských aplikačních služeb
• Postupy: Implementace přihlášení a odhlášení uživatele s využitím klientských aplikačních služeb