ClientFormsAuthenticationMembershipProvider Klasse

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

Vererbung

Object

ProviderBase

MembershipProvider

ClientFormsAuthenticationMembershipProvider

Beispiele

Im folgenden Beispielcode wird veranschaulicht, wie Sie diese Methode verwenden, um den Benutzer mithilfe einer IClientFormsAuthenticationCredentialsProvider Implementierung zu überprüfen.

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

Hinweise

Sie können Clientanwendungsdienste verwenden, um Benutzer mithilfe der Formularauthentifizierung zu überprüfen. Um die Formularauthentifizierung zu aktivieren, konfigurieren Sie Ihre Anwendung für die Verwendung der ClientFormsAuthenticationMembershipProvider -Klasse.

Nach der Konfiguration können Sie Benutzer überprüfen, indem Sie die staticMembership.ValidateUser -Methode aufrufen, die intern die ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) -Methode aufruft.

Die Formularauthentifizierung erfordert, dass der Benutzer seine Anmeldeinformationen über von Ihrer Anwendung bereitgestellte Anmeldesteuerelemente angibt. Sie können die Anmeldeinformationen abrufen und an die Membership.ValidateUser -Methode übergeben. Sie können auch leere Zeichenfolgen übergeben oder null einen Anmeldeinformationsanbieter verwenden. Ein Anmeldeinformationsanbieter ist eine Implementierung, die in Ihrer Anwendungskonfigurationsdatei IClientFormsAuthenticationCredentialsProvider angegeben ist. In der Regel implementieren Sie die IClientFormsAuthenticationCredentialsProvider.GetCredentials Methode, um ein Anmeldedialogfeld anzuzeigen und ein aufgefülltes ClientFormsAuthenticationCredentials Objekt zurückzugeben. Die Verwendung eines Anmeldeinformationsanbieters ermöglicht es Ihnen, ein einziges Anmeldedialogfeld für mehrere Anwendungen zu verwenden.

Die ClientFormsAuthenticationMembershipProvider.ValidateUser -Methode authentifiziert Benutzer über den Anmeldedienst, der von der ServiceUri -Eigenschaft angegeben wird. Der Wert der -Eigenschaft wird in der ServiceUri Regel aus der Anwendungskonfigurationsdatei zusammen mit anderen Konfigurationswerten abgerufen.

Wenn der Benutzer erfolgreich authentifiziert wurde, legt der Dienstanbieter die staticThread.CurrentPrincipal Eigenschaft auf ein neues ClientRolePrincipal Objekt fest, das ein neues ClientFormsIdentity Objekt enthält, das die Benutzerinformationen enthält. Wenn ein ClientRoleProvider für Ihre Anwendung konfiguriert ist, können Sie das ClientRolePrincipal -Objekt verwenden, um Benutzerrolleninformationen aus dem Rollendienst abzurufen.

Sie können einen Verweis auf den aktuellen ClientFormsAuthenticationMembershipProvider instance über die staticMembership.Provider -Eigenschaft abrufen. Sie können den Verweis auf den Mitgliedschaftsanbieter verwenden, um die ClientFormsAuthenticationMembershipProvider.ValidateUser -Methode direkt aufzurufen. Darüber hinaus benötigen Sie den Verweis auf den Mitgliedschaftsanbieter, um die Logout -Methode aufzurufen, die in der MembershipProvider Basisklasse nicht verfügbar ist.

Sie können die ClientFormsAuthenticationMembershipProvider -Klasse nicht verwenden, um Mitgliedschaftsinformationen zu erstellen, zu löschen oder zu ändern. Zum Erstellen, Löschen oder Ändern von Benutzern müssen Sie die Konfiguration des Anmeldediensts auf dem Server ändern.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• ValidateUser
• ValidateUser(String, String)
• Clientanwendungsdienste
• Gewusst wie: Konfigurieren von Clientanwendungsdiensten
• Vorgehensweise: Implementieren der Benutzeranmeldung und -abmeldung mit Client Application Services