MembershipProvider Klasse
Definition
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::ProviderBasepublic abstract class MembershipProvider : System.Configuration.Provider.ProviderBasetype MembershipProvider = class
inherit ProviderBasePublic MustInherit Class MembershipProvider
Inherits ProviderBase- Vererbung
- Abgeleitet
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. |
