ClientFormsAuthenticationMembershipProvider Klasse

Referenz

Definition

Namespace:: System.Web.ClientServices.Providers

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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:

Freigeben über