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 so, dass sie die ClientFormsAuthenticationMembershipProvider Klasse verwendet.

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.

Für die Formularauthentifizierung muss der Benutzer seine Anmeldeinformationen über Anmeldesteuerelemente angeben, die von Ihrer Anwendung bereitgestellt werden. Sie können die Anmeldeinformationen abrufen und an die Membership.ValidateUser-Methode übergeben. Sie können auch leere Zeichenfolgen oder null übergeben, um einen Anmeldeinformationsanbieter zu verwenden. Ein Anmeldeinformationsanbieter ist eine in Ihrer Anwendungskonfigurationsdatei angegebene IClientFormsAuthenticationCredentialsProvider Implementierung. In der Regel implementieren Sie die IClientFormsAuthenticationCredentialsProvider.GetCredentials-Methode, um ein Anmeldedialogfeld anzuzeigen und ein ausgefülltes ClientFormsAuthenticationCredentials-Objekt zurückzugeben. Mithilfe eines Anmeldeinformationsanbieters können Sie ein einzelnes Anmeldedialogfeld für mehrere Anwendungen freigeben.

Die ClientFormsAuthenticationMembershipProvider.ValidateUser-Methode authentifiziert Benutzer über den Anmeldedienst, der durch die eigenschaft ServiceUri angegeben ist. Der Wert der ServiceUri-Eigenschaft wird in der Regel zusammen mit anderen Konfigurationswerten aus der Anwendungskonfigurationsdatei 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 eine 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 die aktuelle ClientFormsAuthenticationMembershipProvider Instanz über die eigenschaft staticMembership.Provider abrufen. Sie können den Mitgliedschaftsanbieterverweis verwenden, um die ClientFormsAuthenticationMembershipProvider.ValidateUser Methode direkt aufzurufen. Darüber hinaus benötigen Sie den Mitgliedschaftsanbieterverweis, 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
• How to: Configure Client Application Services
• How to: Implement User Login and Logout with Client Application Services