MembershipProvider Klasse

Referenz

Definition

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Assembly:: System.Web.ApplicationServices.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.

Definiert den Vertrag, den ASP.NET implementiert, um Mitgliedschaftsdienste unter Verwendung benutzerdefinierter Mitgliedschaftsanbieter bereitzustellen.

public ref class MembershipProvider abstract : System::Configuration::Provider::ProviderBase

public abstract class MembershipProvider : System.Configuration.Provider.ProviderBase

type MembershipProvider = class
    inherit ProviderBase

Public MustInherit Class MembershipProvider
Inherits ProviderBase

Vererbung: Object

ProviderBase
MembershipProvider

Abgeleitet: System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider

System.Web.ClientServices.Providers.ClientWindowsAuthenticationMembershipProvider

System.Web.Security.ActiveDirectoryMembershipProvider

System.Web.Security.SqlMembershipProvider

Hinweise

Hinweis

ASP.NET Mitgliedschaftsanbieter wurden von ASP.NET Identity abgelöst. Es wird dringend empfohlen, Apps so zu aktualisieren, dass sie die ASP.NET Identity Platform anstelle der Mitgliedschaftsanbieter verwenden.

ASP.NET Mitgliedschaft ist so konzipiert, dass Sie problemlos eine Reihe verschiedener Mitgliedschaftsanbieter für Ihre ASP.NET-Anwendungen verwenden können. Sie können die angegebenen Mitgliedschaftsanbieter verwenden, die in .NET Framework enthalten sind, oder Sie können Einen eigenen Anbieter implementieren.

Hinweis

Wenn Sie mit den Mitgliedschaftsfeatures von ASP.NET nicht vertraut sind, lesen Sie die Einführung in die Mitgliedschaft , bevor Sie fortfahren. Eine Liste mit anderen Themen im Zusammenhang mit der Mitgliedschaft finden Sie unter Verwalten von Benutzern mithilfe der Mitgliedschaft.

Wenn Sie einen benutzerdefinierten Mitgliedschaftsanbieter implementieren, müssen Sie die MembershipProvider abstrakte Klasse erben.

Es gibt zwei Hauptgründe für das Erstellen eines benutzerdefinierten Mitgliedschaftsanbieters.

Sie müssen Mitgliedschaftsinformationen in einer Datenquelle speichern, die von den im .NET Framework enthaltenen Mitgliedschaftsanbietern nicht unterstützt wird, z. B. eine FoxPro-Datenbank, eine Oracle-Datenbank oder eine andere Datenquelle.
Sie müssen Mitgliedschaftsinformationen mithilfe eines Datenbankschemas verwalten, das sich von dem Datenbankschema unterscheidet, das von den Anbietern verwendet wird, die mit .NET Framework ausgeliefert werden. Ein gängiges Beispiel hierfür sind Mitgliedschaftsdaten, die bereits in einer SQL Server-Datenbank für ein Unternehmen oder eine Website vorhanden sind.

Die MembershipProvider abstrakte Klasse erbt von der ProviderBase abstrakten Klasse. MembershipProvider Implementierungen müssen auch die erforderlichen Member von ProviderBaseimplementieren.

Konstruktoren

MembershipProvider()

Initialisiert eine neue Instanz der MembershipProvider-Klasse.

Eigenschaften

ApplicationName	Der Name der Anwendung, die den benutzerdefinierten Mitgliedschaftsanbieter verwendet.
Description	Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen geeignet ist. (Geerbt von ProviderBase)
EnablePasswordReset	Gibt an, ob der Mitgliedschaftsanbieter so konfiguriert ist, dass Benutzer ihre Kennwörter zurücksetzen können.
EnablePasswordRetrieval	Gibt an, ob der Mitgliedschaftsanbieter so konfiguriert ist, dass Benutzer ihre Kennwörter abrufen können.
MaxInvalidPasswordAttempts	Ruft die Anzahl der zulässigen ungültigen Kennwort- oder Kennwortantwortversuche ab, bevor der Mitgliedschaftsbenutzer ausgesperrt wird.
MinRequiredNonAlphanumericCharacters	Ruft die minimale Anzahl von Sonderzeichen ab, die ein gültiges Kennwort enthalten muss.
MinRequiredPasswordLength	Ruft die minimale erforderliche Länge für ein Kennwort ab.
Name	Ruft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Geerbt von ProviderBase)
PasswordAttemptWindow	Ruft die Anzahl der Minuten ab, innerhalb der eine maximale Anzahl von ungültigen Kennwort- oder Kennwortantwortversuchen zulässig ist, bevor der Mitgliedschaftsbenutzer ausgesperrt wird.
PasswordFormat	Ruft einen Wert ab, der das Format zum Speichern von Kennwörtern im Mitgliedschaftsdatenspeicher angibt.
PasswordStrengthRegularExpression	Ruft den regulären Ausdruck ab, der zum Auswerten eines Kennworts verwendet wird.
RequiresQuestionAndAnswer	Ruft einen Wert ab, der angibt, ob der Mitgliedschaftsanbieter so konfiguriert ist, dass vom Benutzer beim Zurücksetzen und Abrufen des Kennworts die Beantwortung einer Kennwortfrage gefordert wird.
RequiresUniqueEmail	Ruft einen Wert ab, der angibt, ob der Mitgliedschaftsanbieter so konfiguriert ist, dass eine eindeutige E-Mail-Adresse für jeden Benutzernamen erforderlich ist.

Methoden

ChangePassword(String, String, String)	Verarbeitet eine Anforderung zum Aktualisieren des Kennworts für einen Mitgliedschaftsbenutzer.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Verarbeitet eine Anforderung zum Aktualisieren der Kennwortfrage und -antwort für einen Mitgliedschaftsbenutzer.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Fügt der Datenquelle einen neuen Mitgliedschaftsbenutzer hinzu.
DecryptPassword(Byte[])	Entschlüsselt ein verschlüsseltes Kennwort.
DeleteUser(String, Boolean)	Entfernt einen Benutzer aus der Mitgliedschaftsdatenquelle.
EncryptPassword(Byte[])	Verschlüsselt ein Kennwort.
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Verschlüsselt das angegebene Kennwort mithilfe des angegebenen Kennwortkompatibilitätsmodus.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Ruft eine Auflistung von Mitgliedschaftsbenutzern ab, bei denen die E-Mail-Adresse die zu vergleichende angegebene E-Mail-Adresse enthält.
FindUsersByName(String, Int32, Int32, Int32)	Ruft eine Auflistung von Mitgliedschaftsbenutzern ab, deren Benutzername den angegebenen Vergleichsbenutzernamen enthält.
GetAllUsers(Int32, Int32, Int32)	Ruft eine Auflistung aller Benutzer in der Datenquelle in Datenseiten ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetNumberOfUsersOnline()	Ruft die Anzahl von Benutzern ab, die derzeit auf die Anwendung zugreifen.
GetPassword(String, String)	Ruft das Kennwort für den angegebenen Benutzernamen aus der Datenquelle ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetUser(Object, Boolean)	Ruft Benutzerinformationen auf Basis des eindeutigen Bezeichners für den Mitgliedschaftsbenutzer aus der Datenquelle ab. Stellt eine Option zum Aktualisieren des Datums/Zeitstempels der letzten Aktivität für den Benutzer bereit.
GetUser(String, Boolean)	Ruft Informationen von der Datenquelle für einen Benutzer ab. Stellt eine Option zum Aktualisieren des Datums/Zeitstempels der letzten Aktivität für den Benutzer bereit.
GetUserNameByEmail(String)	Ruft den Benutzernamen ab, der der angegebenen E-Mail-Adresse zugeordnet ist.
Initialize(String, NameValueCollection)	Initialisiert den Konfigurations-Generator. (Geerbt von ProviderBase)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Löst das ValidatingPassword-Ereignis aus, wenn ein Ereignishandler definiert wurde.
ResetPassword(String, String)	Setzt das Kennwort eines Benutzers auf ein neues, automatisch generiertes Kennwort zurück.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
UnlockUser(String)	Hebt eine Sperre auf, sodass der Mitgliedschaftsbenutzer überprüft werden kann.
UpdateUser(MembershipUser)	Aktualisiert Informationen zu einem Benutzer in der Datenquelle.
ValidateUser(String, String)	Stellt sicher, dass der angegebene Benutzername und das Kennwort in der Datenquelle vorhanden sind.

Ereignisse

ValidatingPassword

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

Gilt für:

Freigeben über