MembershipProvider Klasse

Definition

Definiert den Vertrag, den ASP.NET implementiert, um Mitgliedschaftsdienste mit benutzerdefinierten Mitgliedschaftsanbietern bereitzustellen.Defines the contract that ASP.NET implements to provide membership services using custom membership providers.

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

Die ASP.NET-Mitgliedschaft ist so konzipiert, dass Sie problemlos eine Reihe von verschiedenen Mitgliedschafts Anbietern für Ihre ASP.NET-Anwendungen verwenden können.ASP.NET membership is designed to enable you to easily use a number of different membership providers for your ASP.NET applications. Sie können die angegebenen Mitgliedschafts Anbieter verwenden, die im .NET Framework enthalten sind, oder Sie können einen eigenen Anbieter implementieren.You can use the supplied membership providers that are included with the .NET Framework, or you can implement your own provider.

Hinweis

Wenn Sie mit den Mitgliedschafts Features von ASP.net nicht vertraut sind, finden Sie weitere Informationen unter Introduction to Membership , bevor Sie fortfahren.If you are not familiar with the membership features of ASP.NET, see Introduction to Membership before continuing. Eine Liste mit anderen Themen im Zusammenhang mit der Mitgliedschaft finden Sie unter Verwalten von Benutzern mithilfe der Mitgliedschaft.For a list of other topics related to membership, see Managing Users by Using Membership.

Beim Implementieren eines benutzerdefinierten Mitgliedschafts Anbieters müssen Sie die MembershipProvider abstrakte-Klasse erben.When implementing a custom membership provider, you are required to inherit the MembershipProvider abstract class.

Es gibt zwei Hauptgründe für das Erstellen eines benutzerdefinierten Mitgliedschafts Anbieters.There are two primary reasons for creating a custom membership provider.

  • Sie müssen Mitgliedschafts Informationen in einer Datenquelle speichern, die nicht von den im .NET Framework enthaltenen Mitgliedschafts Anbietern unterstützt wird, z. b. eine FoxPro-Datenbank, eine Oracle-Datenbank oder eine andere Datenquelle.You need to store membership information in a data source that is not supported by the membership providers included with the .NET Framework, such as a FoxPro database, an Oracle database, or other data source.

  • Sie müssen Mitgliedschafts Informationen mithilfe eines Datenbankschemas verwalten, das sich von dem Datenbankschema unterscheidet, das von den Anbietern verwendet wird, die im .NET Framework enthalten sind.You need to manage membership information using a database schema that is different from the database schema used by the providers that ship with the .NET Framework. Ein gängiges Beispiel hierfür sind Mitgliedschafts Daten, die bereits in einer SQL Server Datenbank für ein Unternehmen oder eine Website vorhanden sind.A common example of this would be membership data that already exists in a SQL Server database for a company or Web site.

Die MembershipProvider abstrakte-Klasse erbt von ProviderBase der abstrakten-Klasse.The MembershipProvider abstract class inherits from the ProviderBase abstract class. MembershipProviderImplementierungen müssen außerdem die erforderlichen Member von ProviderBaseimplementieren.MembershipProvider implementations must also implement the required members of ProviderBase.

Konstruktoren

MembershipProvider()

Initialisiert eine neue Instanz der MembershipProvider-Klasse.Initializes a new instance of the MembershipProvider class.

Eigenschaften

ApplicationName

Der Name der Anwendung, die den benutzerdefinierten Mitgliedschaftsanbieter verwendet.The name of the application using the custom membership provider.

Description

Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen geeignet ist.Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Geerbt von ProviderBase)
EnablePasswordReset

Gibt an, ob der Mitgliedschaftsanbieter so konfiguriert ist, dass Benutzer ihre Kennwörter zurücksetzen können.Indicates whether the membership provider is configured to allow users to reset their passwords.

EnablePasswordRetrieval

Gibt an, ob der Mitgliedschaftsanbieter so konfiguriert ist, dass Benutzer ihre Kennwörter abrufen können.Indicates whether the membership provider is configured to allow users to retrieve their passwords.

MaxInvalidPasswordAttempts

Ruft die Anzahl der zulässigen ungültigen Kennworteingaben und Kennwortantworteingaben ab, bevor der Mitgliedschaftsbenutzer gesperrt wird.Gets the number of invalid password or password-answer attempts allowed before the membership user is locked out.

MinRequiredNonAlphanumericCharacters

Ruft die Mindestanzahl der Sonderzeichen ab, die in einem gültigen Kennwort enthalten sein müssen.Gets the minimum number of special characters that must be present in a valid password.

MinRequiredPasswordLength

Ruft die für ein Kennwort erforderliche Mindestlänge ab.Gets the minimum length required for a password.

Name

Ruft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen.Gets the friendly name used to refer to the provider during configuration.

(Geerbt von ProviderBase)
PasswordAttemptWindow

Ruft die Anzahl der Minuten ab, in denen eine maximale Anzahl ungültiger Kennworteingaben und Kennwortantworteingaben zulässig ist, bevor der Mitgliedschaftsbenutzer gesperrt wird.Gets the number of minutes in which a maximum number of invalid password or password-answer attempts are allowed before the membership user is locked out.

PasswordFormat

Ruft einen Wert ab, der das Format zum Speichern von Kennwörtern im Mitgliedschaftsdatenspeicher angibt.Gets a value indicating the format for storing passwords in the membership data store.

PasswordStrengthRegularExpression

Ruft den regulären Ausdruck ab, der zum Auswerten eines Kennworts verwendet wird.Gets the regular expression used to evaluate a password.

RequiresQuestionAndAnswer

Ruft einen Wert ab, der angibt, ob der Mitgliedschaftsanbieter so konfiguriert ist, dass der Benutzer zum Zurücksetzen und Abrufen des Kennworts eine Kennwortfrage beantworten muss.Gets a value indicating whether the membership provider is configured to require the user to answer a password question for password reset and retrieval.

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.Gets a value indicating whether the membership provider is configured to require a unique email address for each user name.

Methoden

ChangePassword(String, String, String)

Verarbeitet eine Anforderung zum Aktualisieren des Kennworts für einen Mitgliedschaftsbenutzer.Processes a request to update the password for a membership user.

ChangePasswordQuestionAndAnswer(String, String, String, String)

Verarbeitet eine Anforderung zum Aktualisieren der Kennwortfrage und -antwort für einen Mitgliedschaftsbenutzer.Processes a request to update the password question and answer for a membership user.

CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

Fügt der Datenquelle einen neuen Mitgliedschaftsbenutzer hinzu.Adds a new membership user to the data source.

DecryptPassword(Byte[])

Entschlüsselt ein verschlüsseltes Kennwort.Decrypts an encrypted password.

DeleteUser(String, Boolean)

Entfernt einen Benutzer aus der Mitgliedschaftsdatenquelle.Removes a user from the membership data source.

EncryptPassword(Byte[])

Verschlüsselt ein Kennwort.Encrypts a password.

EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Verschlüsselt das angegebene Kennwort mithilfe des angegebenen Kennwortkompatibilitätsmodus.Encrypts the specified password using the specified password-compatibility mode.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(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.Gets a collection of membership users where the email address contains the specified email address to match.

FindUsersByName(String, Int32, Int32, Int32)

Ruft eine Auflistung von Mitgliedschaftsbenutzern ab, deren Benutzername den angegebenen Vergleichsbenutzernamen enthält.Gets a collection of membership users where the user name contains the specified user name to match.

GetAllUsers(Int32, Int32, Int32)

Ruft eine Auflistung aller Benutzer in der Datenquelle in Datenseiten ab.Gets a collection of all the users in the data source in pages of data.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetNumberOfUsersOnline()

Ruft die Anzahl der Benutzer ab, die gegenwärtig auf die Anwendung zugreifen.Gets the number of users currently accessing the application.

GetPassword(String, String)

Ruft das Kennwort für den angegebenen Benutzernamen aus der Datenquelle ab.Gets the password for the specified user name from the data source.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetUser(Object, Boolean)

Ruft Benutzerinformationen aus der Datenquelle auf Grundlage des eindeutigen Bezeichners für den Mitgliedschaftsbenutzer ab.Gets user information from the data source based on the unique identifier for the membership user. Stellt eine Option zum Aktualisieren des Datums-/Zeitstempels der letzten Aktivität des Benutzers bereit.Provides an option to update the last-activity date/time stamp for the user.

GetUser(String, Boolean)

Ruft Informationen für einen Benutzer aus der Datenquelle ab.Gets information from the data source for a user. Stellt eine Option zum Aktualisieren des Datums-/Zeitstempels der letzten Aktivität des Benutzers bereit.Provides an option to update the last-activity date/time stamp for the user.

GetUserNameByEmail(String)

Ruft den Benutzernamen ab, der der angegebenen E-Mail-Adresse zugeordnet ist.Gets the user name associated with the specified email address.

Initialize(String, NameValueCollection)

Initialisiert den Konfigurations-Generator.Initializes the configuration builder.

(Geerbt von ProviderBase)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnValidatingPassword(ValidatePasswordEventArgs)

Löst das ValidatingPassword-Ereignis aus, wenn ein Ereignishandler definiert wurde.Raises the ValidatingPassword event if an event handler has been defined.

ResetPassword(String, String)

Setzt das Kennwort eines Benutzers auf ein neues, automatisch generiertes Kennwort zurück.Resets a user's password to a new, automatically generated password.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
UnlockUser(String)

Hebt eine Sperre auf, sodass der Mitgliedschaftsbenutzer überprüft werden kann.Clears a lock so that the membership user can be validated.

UpdateUser(MembershipUser)

Aktualisiert Informationen zu einem Benutzer in der Datenquelle.Updates information about a user in the data source.

ValidateUser(String, String)

Überprüft, ob der angegebene Benutzername und das Kennwort in der Datenquelle vorhanden sind.Verifies that the specified user name and password exist in the data source.

Ereignisse

ValidatingPassword

Tritt ein, wenn ein Benutzer erstellt, ein Kennwort geändert oder ein Kennwort zurückgesetzt wird.Occurs when a user is created, a password is changed, or a password is reset.

Gilt für:

Siehe auch