MembershipProvider Klasse

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll
Assembly:
System.Web.ApplicationServices.dll

Definiert den Vertrag, der ASP.NET implementiert, um Mitgliedschaftsdienste mithilfe von benutzerdefinierten Mitgliedschaftsanbietern 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

Hinweise

Note

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

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

Note

Wenn Sie mit den Mitgliedschaftsfunktionen 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.

Bei der Implementierung eines benutzerdefinierten Mitgliedschaftsanbieters müssen Sie die MembershipProvider abstrakte Klasse erben.

Es gibt zwei Hauptgründe für die Erstellung eines benutzerdefinierten Mitgliedschaftsanbieters.

  • Sie müssen Mitgliedschaftsinformationen in einer Datenquelle speichern, die nicht von den Mitgliedschaftsanbietern unterstützt wird, die im .NET Framework enthalten sind, 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 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 ProviderBase.

Konstruktoren

Name Beschreibung
MembershipProvider()

Initialisiert eine neue Instanz der MembershipProvider-Klasse.

Eigenschaften

Name Beschreibung
ApplicationName

Der Name der Anwendung mit dem benutzerdefinierten Mitgliedschaftsanbieter.
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

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 ungültiger Kennwort- oder Kennwortantwortversuche ab, die zulässig sind, bevor der Mitgliedschaftsbenutzer gesperrt ist.
MinRequiredNonAlphanumericCharacters

Ruft die minimale Anzahl von Sonderzeichen ab, die in einem gültigen Kennwort vorhanden sein müssen.
MinRequiredPasswordLength

Ruft die Mindestlänge für ein Kennwort ab.
Name

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

(Geerbt von ProviderBase)
PasswordAttemptWindow

Ruft die Anzahl der Minuten ab, in denen eine maximale Anzahl ungültiger Kennwort- oder Kennwortantwortversuche zulässig sind, bevor der Mitgliedschaftsbenutzer gesperrt 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 der Benutzer eine Kennwortfrage zur Kennwortzurücksetzung und zum Abrufen beantworten muss.
RequiresUniqueEmail

Ruft einen Wert ab, der angibt, ob der Mitgliedschaftsanbieter so konfiguriert ist, dass für jeden Benutzernamen eine eindeutige E-Mail-Adresse erforderlich ist.

Methoden

Name Beschreibung
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[], MembershipPasswordCompatibilityMode)

Verschlüsselt das angegebene Kennwort mithilfe des angegebenen Kennwortkompatibilitätsmodus.
EncryptPassword(Byte[])

Verschlüsselt ein Kennwort.
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

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

Ruft eine Sammlung von Mitgliedschaftsbenutzern ab, bei denen die E-Mail-Adresse die angegebene E-Mail-Adresse enthält, die übereinstimmen soll.
FindUsersByName(String, Int32, Int32, Int32)

Ruft eine Sammlung von Mitgliedschaftsbenutzern ab, in denen der Benutzername den angegebenen Benutzernamen enthält, der übereinstimmen soll.
GetAllUsers(Int32, Int32, Int32)

Ruft eine Auflistung aller Benutzer in der Datenquelle auf Seiten von Daten ab.
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetNumberOfUsersOnline()

Ruft die Anzahl der Benutzer ab, die derzeit auf die Anwendung zugreifen.
GetPassword(String, String)

Ruft das Kennwort für den angegebenen Benutzernamen aus der Datenquelle ab.
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUser(Object, Boolean)

Ruft Benutzerinformationen aus der Datenquelle basierend auf dem eindeutigen Bezeichner für den Mitgliedschaftsbenutzer ab. Bietet eine Option zum Aktualisieren des Datums-/Uhrzeitstempels der letzten Aktivität für den Benutzer.
GetUser(String, Boolean)

Ruft Informationen aus der Datenquelle für einen Benutzer ab. Bietet eine Option zum Aktualisieren des Datums-/Uhrzeitstempels der letzten Aktivität für den Benutzer.
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 der 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)

Löscht eine Sperre, damit der Mitgliedschaftsbenutzer überprüft werden kann.
UpdateUser(MembershipUser)

Aktualisiert Informationen zu einem Benutzer in der Datenquelle.
ValidateUser(String, String)

Überprüft, ob der angegebene Benutzername und das angegebene Kennwort in der Datenquelle vorhanden sind.

Ereignisse

Name Beschreibung
ValidatingPassword

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

Gilt für:

Weitere Informationen