MembershipProvider Klasse

Definition

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
MembershipProvider
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. einer FoxPro-Datenbank, einer Oracle-Datenbank oder einer anderen Datenquelle.

  • Sie müssen Mitgliedschaftsinformationen mithilfe eines Datenbankschemas verwalten, das sich von dem Datenbankschema unterscheidet, das von den Anbietern verwendet wird, die mit dem .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:

Weitere Informationen