ClientFormsAuthenticationMembershipProvider Třída

Definice

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

Vlastnosti

Metody

Událost

Platí pro

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