ClientFormsAuthenticationMembershipProvider Klasse

Definition

Aktiviert die Formularauthentifizierung mit Clientanwendungsdiensten.

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
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

ClientFormsAuthenticationMembershipProvider()

Initialisiert eine neue Instanz der ClientFormsAuthenticationMembershipProvider Klasse.

Eigenschaften

ApplicationName

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

Description

Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen (UIs) geeignet ist.

(Geerbt von ProviderBase)
EnablePasswordReset

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

EnablePasswordRetrieval

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

MaxInvalidPasswordAttempts

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

MinRequiredNonAlphanumericCharacters

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

MinRequiredPasswordLength

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

Name

Ruft den Anzeigenamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen.

(Geerbt von ProviderBase)
PasswordAttemptWindow

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

PasswordFormat

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

PasswordStrengthRegularExpression

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

RequiresQuestionAndAnswer

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

RequiresUniqueEmail

Diese Eigenschaft wird von dieser Klasse nicht verwendet.

ServiceUri

Dient zum Abrufen oder Festlegen des URI des Authentifizierungsdiensts.

Methoden

ChangePassword(String, String, String)

Diese Methode wird von dieser Klasse nicht verwendet.

ChangePasswordQuestionAndAnswer(String, String, String, String)

Diese Methode wird von dieser Klasse nicht verwendet.

CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

Diese Methode wird von dieser Klasse nicht verwendet.

DecryptPassword(Byte[])

Entschlüsselt ein verschlüsseltes Kennwort.

(Geerbt von MembershipProvider)
DeleteUser(String, Boolean)

Diese Methode wird von dieser Klasse nicht verwendet.

EncryptPassword(Byte[])

Verschlüsselt ein Kennwort.

(Geerbt von MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Verschlüsselt das angegebene Kennwort mithilfe des angegebenen Kennwortkompatibilitätsmodus.

(Geerbt von MembershipProvider)
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
FindUsersByEmail(String, Int32, Int32, Int32)

Diese Methode wird von dieser Klasse nicht verwendet.

FindUsersByName(String, Int32, Int32, Int32)

Diese Methode wird von dieser Klasse nicht verwendet.

GetAllUsers(Int32, Int32, Int32)

Diese Methode wird von dieser Klasse nicht verwendet.

GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetNumberOfUsersOnline()

Diese Methode wird von dieser Klasse nicht verwendet.

GetPassword(String, String)

Diese Methode wird von dieser Klasse nicht verwendet.

GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUser(Object, Boolean)

Diese Methode wird von dieser Klasse nicht verwendet.

GetUser(String, Boolean)

Diese Methode wird von dieser Klasse nicht verwendet.

GetUserNameByEmail(String)

Diese Methode wird von dieser Klasse nicht verwendet.

Initialize(String, NameValueCollection)

Initialisiert den Anbieter.

Logout()

Meldet den Benutzer ab.

MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
OnValidatingPassword(ValidatePasswordEventArgs)

Löst das ValidatingPassword Ereignis aus, wenn ein Ereignishandler definiert wurde.

(Geerbt von MembershipProvider)
ResetPassword(String, String)

Diese Methode wird von dieser Klasse nicht verwendet.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
UnlockUser(String)

Diese Methode wird von dieser Klasse nicht verwendet.

UpdateUser(MembershipUser)

Diese Methode wird von dieser Klasse nicht verwendet.

ValidateUser(String, String)

Authentifiziert einen Benutzer mithilfe des angegebenen Benutzernamens und Kennworts.

ValidateUser(String, String, Boolean)

Authentifiziert einen Benutzer mithilfe des angegebenen Benutzernamens und Kennworts und speichert optional einen Hash des Kennworts im lokalen Datencache.

ValidateUser(String, String, String)

Authentifiziert einen Benutzer am angegebenen Dienst-URI mithilfe des angegebenen Benutzernamens und Kennworts.

Ereignisse

UserValidated

Tritt auf, wenn der Benutzer überprüft wird.

ValidatingPassword

Tritt auf, wenn ein Benutzer erstellt wird, ein Kennwort geändert oder ein Kennwort zurückgesetzt wird.

(Geerbt von MembershipProvider)

Gilt für:

Weitere Informationen