ClientFormsAuthenticationMembershipProvider Třída

Definice

Obor názvů:

System.Web.ClientServices.Providers

Sestavení:

System.Web.Extensions.dll

Umožňuje ověřování 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

Pomocí služeb klientských aplikací 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 ClientFormsAuthenticationMembershipProvider třídu .

Po konfiguraci můžete uživatele ověřit voláním staticMembership.ValidateUser metody, 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ů 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 zprostředkovatele 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 pro zobrazení dialogového IClientFormsAuthenticationCredentialsProvider.GetCredentials okna přihlášení a vrácení vyplněného ClientFormsAuthenticationCredentials objektu. Použití zprostředkovatele 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 pomocí objektu ClientRolePrincipal načíst informace o rolích uživatele ze služby Role.

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í pro 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í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 odkaz na poskytovatele 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 hesly. (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()	Získá aktuální Type instanci. (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 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ěří uživatele pomocí zadaného uživatelského jména a hesla.
ValidateUser(String, String, Boolean)	Ověří 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	Nastane při ověření uživatele.
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é aplikační služby
• Postupy: Konfigurace klientských aplikačních služeb
• Postupy: Implementace přihlášení a odhlášení uživatele pomocí klientských aplikačních služeb