ClientFormsAuthenticationMembershipProvider Klas

Definitie

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

Overname

Object

ProviderBase

MembershipProvider

ClientFormsAuthenticationMembershipProvider

Voorbeelden

De volgende voorbeeldcode laat zien hoe u deze methode gebruikt om de gebruiker te valideren met behulp van een IClientFormsAuthenticationCredentialsProvider implementatie.

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

Opmerkingen

U kunt clienttoepassingsservices gebruiken om gebruikers te valideren met behulp van formulierverificatie. Als u formulierverificatie wilt inschakelen, configureert u uw toepassing voor het gebruik van de ClientFormsAuthenticationMembershipProvider klasse.

Na de configuratie kunt u gebruikers valideren door de staticMembership.ValidateUser methode aan te roepen, waarmee de ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) methode intern wordt aangeroepen.

Voor formulierverificatie moet de gebruiker zijn referenties opgeven via aanmeldingsbesturingselementen die door uw toepassing worden geleverd. U kunt de referenties ophalen en doorgeven aan de Membership.ValidateUser methode. U kunt ook lege tekenreeksen doorgeven of null een referentieprovider gebruiken. Een referentieprovider is een IClientFormsAuthenticationCredentialsProvider implementatie die is opgegeven in uw toepassingsconfiguratiebestand. Doorgaans implementeert u de methode voor het IClientFormsAuthenticationCredentialsProvider.GetCredentials weergeven van een aanmeldingsdialoogvenster en retourneert u een ingevuld ClientFormsAuthenticationCredentials object. Met behulp van een referentieprovider kunt u één aanmeldingsdialoogvenster tussen meerdere toepassingen delen.

De ClientFormsAuthenticationMembershipProvider.ValidateUser methode verifieert gebruikers via de aanmeldingsservice die wordt aangegeven door de ServiceUri eigenschap. De waarde van de eigenschap wordt doorgaans opgehaald uit het configuratiebestand van de ServiceUri toepassing, samen met andere configuratiewaarden.

Als de gebruiker is geverifieerd, stelt de serviceprovider de staticThread.CurrentPrincipal eigenschap in op een nieuw object dat een nieuw ClientRolePrincipalClientFormsIdentity object bevat dat de gebruikersgegevens bevat. Als een ClientRoleProvider is geconfigureerd voor uw toepassing, kunt u het ClientRolePrincipal object gebruiken om gebruikersrolgegevens op te halen uit de functieservice.

U kunt een verwijzing naar het huidige ClientFormsAuthenticationMembershipProvider exemplaar ophalen via de staticMembership.Provider eigenschap. U kunt de verwijzing van de lidmaatschapsprovider gebruiken om de ClientFormsAuthenticationMembershipProvider.ValidateUser methode rechtstreeks aan te roepen. Daarnaast hebt u de verwijzing van de lidmaatschapsprovider nodig om de Logout methode aan te roepen, die niet beschikbaar is in de MembershipProvider basisklasse.

U kunt de ClientFormsAuthenticationMembershipProvider klasse niet gebruiken om lidmaatschapsgegevens te maken, te verwijderen of te wijzigen. Als u gebruikers wilt maken, verwijderen of wijzigen, moet u de configuratie van de aanmeldingsservice op de server wijzigen.

Zie ook

• ValidateUser
• ValidateUser(String, String)
• Client Application Services
• Procedure: Client Application Services configureren
• Procedure: Gebruikersaanmelding en afmelding implementeren met Client Application Services