ClientFormsAuthenticationMembershipProvider Klass

Definition

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

Arv

Object

ProviderBase

MembershipProvider

ClientFormsAuthenticationMembershipProvider

Exempel

Följande exempelkod visar hur du använder den här metoden för att verifiera användaren med hjälp av en IClientFormsAuthenticationCredentialsProvider implementering.

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

Kommentarer

Du kan använda klientprogramtjänster för att verifiera användare med hjälp av formulärautentisering. Om du vill aktivera formulärautentisering konfigurerar du programmet så att det ClientFormsAuthenticationMembershipProvider använder klassen.

Efter konfigurationen kan du verifiera användare genom att anropa staticMembership.ValidateUser metoden, som internt anropar ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) metoden.

Formulärautentisering kräver att användaren anger sina autentiseringsuppgifter via inloggningskontroller som tillhandahålls av ditt program. Du kan hämta autentiseringsuppgifterna och skicka dem till Membership.ValidateUser metoden. Du kan också skicka in tomma strängar eller null använda en autentiseringsprovider. En autentiseringsprovider är en IClientFormsAuthenticationCredentialsProvider implementering som anges i programkonfigurationsfilen. Du implementerar IClientFormsAuthenticationCredentialsProvider.GetCredentials vanligtvis metoden för att visa en inloggningsdialogruta och returnera ett ifyllt ClientFormsAuthenticationCredentials objekt. Med hjälp av en provider för autentiseringsuppgifter kan du dela en dialogruta för enkel inloggning mellan flera program.

Metoden ClientFormsAuthenticationMembershipProvider.ValidateUser autentiserar användare via inloggningstjänsten som anges av egenskapen ServiceUri . Värdet för ServiceUri egenskapen hämtas vanligtvis från programkonfigurationsfilen tillsammans med andra konfigurationsvärden.

Om användaren har autentiserats anger staticThread.CurrentPrincipal tjänstleverantören egenskapen till ett nytt ClientRolePrincipal objekt som innehåller ett nytt ClientFormsIdentity objekt som innehåller användarinformationen. Om en ClientRoleProvider har konfigurerats för ditt program kan du använda ClientRolePrincipal objektet för att hämta information om användarrollen från rolltjänsten.

Du kan hämta en referens till den aktuella ClientFormsAuthenticationMembershipProvider instansen via egenskapen staticMembership.Provider . Du kan använda referensen för medlemskapsprovidern för att anropa ClientFormsAuthenticationMembershipProvider.ValidateUser metoden direkt. Dessutom behöver du referensen för medlemskapsprovidern för att anropa Logout metoden, som inte är tillgänglig i basklassen MembershipProvider .

Du kan inte använda ClientFormsAuthenticationMembershipProvider klassen för att skapa, ta bort eller ändra medlemskapsinformation. Om du vill skapa, ta bort eller ändra användare måste du ändra konfigurationen för inloggningstjänsten på servern.

Se även

• ValidateUser
• ValidateUser(String, String)
• Klientprogramtjänster
• Så här konfigurerar du klientprogramtjänster
• Gör så här: Implementera användarinloggning och utloggning med klientprogramtjänster