ClientFormsAuthenticationMembershipProvider Classe

Definizione

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

Ereditarietà

Object

ProviderBase

MembershipProvider

ClientFormsAuthenticationMembershipProvider

Esempio

Il codice di esempio seguente illustra come usare questo metodo per convalidare l'utente usando un'implementazione IClientFormsAuthenticationCredentialsProvider .

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

Commenti

È possibile usare i servizi dell'applicazione client per convalidare gli utenti usando l'autenticazione basata su form. Per abilitare l'autenticazione basata su form, configurare l'applicazione per l'uso della ClientFormsAuthenticationMembershipProvider classe .

Dopo la configurazione, è possibile convalidare gli utenti chiamando il staticMembership.ValidateUser metodo , che chiama internamente il ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) metodo .

L'autenticazione basata su form richiede che l'utente specifichi le proprie credenziali tramite i controlli di accesso forniti dall'applicazione. È possibile recuperare le credenziali e passarle al Membership.ValidateUser metodo . È anche possibile passare stringhe vuote o null usare un provider di credenziali. Un provider di credenziali è un'implementazione IClientFormsAuthenticationCredentialsProvider specificata nel file di configurazione dell'applicazione. In genere si implementerà il IClientFormsAuthenticationCredentialsProvider.GetCredentials metodo per visualizzare una finestra di dialogo di accesso e restituire un oggetto popolato ClientFormsAuthenticationCredentials . L'uso di un provider di credenziali consente di condividere una singola finestra di dialogo di accesso tra più applicazioni.

Il ClientFormsAuthenticationMembershipProvider.ValidateUser metodo autentica gli utenti tramite il servizio di accesso indicato dalla ServiceUri proprietà . Il valore della ServiceUri proprietà viene in genere recuperato dal file di configurazione dell'applicazione insieme ad altri valori di configurazione.

Se l'utente viene autenticato correttamente, il provider di servizi imposta la staticThread.CurrentPrincipal proprietà su un nuovo ClientRolePrincipal oggetto contenente un nuovo ClientFormsIdentity oggetto contenente le informazioni utente. Se un ClientRoleProvider oggetto è configurato per l'applicazione, è possibile usare l'oggetto ClientRolePrincipal per recuperare le informazioni sul ruolo utente dal servizio ruoli.

È possibile recuperare un riferimento all'istanza corrente ClientFormsAuthenticationMembershipProvider tramite la staticMembership.Provider proprietà . È possibile usare il riferimento al provider di appartenenze per chiamare direttamente il ClientFormsAuthenticationMembershipProvider.ValidateUser metodo . Inoltre, sarà necessario il riferimento del provider di appartenenze per chiamare il Logout metodo , che non è disponibile nella MembershipProvider classe base.

Non è possibile usare la ClientFormsAuthenticationMembershipProvider classe per creare, eliminare o modificare le informazioni sull'appartenenza. Per creare, eliminare o modificare gli utenti, è necessario modificare la configurazione del servizio di accesso nel server.

Vedi anche

• ValidateUser
• ValidateUser(String, String)
• Servizi applicazioni client
• Procedura: Configurare i servizi applicazione client
• Procedura: Implementare l'accesso utente e la disconnessione con i servizi applicazione client