MembershipProvider 类

定义

命名空间:

System.Web.Security

程序集:

System.Web.ApplicationServices.dll

定义 ASP.NET 为使用自定义成员资格提供程序提供成员资格服务而实现的协定。

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

继承

Object

ProviderBase

MembershipProvider

派生

System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider

System.Web.ClientServices.Providers.ClientWindowsAuthenticationMembershipProvider

System.Web.Security.ActiveDirectoryMembershipProvider

System.Web.Security.SqlMembershipProvider

注解

注意

ASP.NET 成员身份提供程序已被 ASP.NET 标识取代。 强烈建议更新应用以使用 ASP.NET 标识平台，而不是成员资格提供程序。

ASP.NET 成员身份旨在使你能够轻松地为 ASP.NET 应用程序使用许多不同的成员资格提供程序。 可以使用 .NET Framework 随附的提供的成员资格提供程序，也可以实现自己的提供程序。

注意

如果不熟悉 ASP.NET 的成员身份功能，请参阅 成员资格简介， 然后再继续。 有关与成员身份相关的其他主题的列表，请参阅 使用成员身份管理用户。

实现自定义成员资格提供程序时，需要继承 MembershipProvider 抽象类。

创建自定义成员资格提供程序有两个主要原因。

• 需要在 .NET Framework 中包含的成员资格提供程序不支持的数据源中存储成员身份信息，例如 FoxPro 数据库、Oracle 数据库或其他数据源。

• 需要使用与 .NET Framework 附带的提供程序所使用的数据库架构不同的数据库架构来管理成员身份信息。 这种情况的一个常见示例是公司或网站的 SQL Server 数据库中已存在的成员身份数据。

MembershipProvider抽象类继承自ProviderBase抽象类。 MembershipProvider 实现还必须实现 所需的成员 ProviderBase。

构造函数

MembershipProvider()

初始化 MembershipProvider 类的新实例。

属性

ApplicationName	使用自定义成员资格提供程序的应用程序的名称。
Description	获取一条简短的易懂描述，它适合在管理工具或其他用户界面 (UI) 中显示。 (继承自 ProviderBase)
EnablePasswordReset	指示成员资格提供程序是否被配置为允许用户重置其密码。
EnablePasswordRetrieval	指示成员资格提供程序是否配置为允许用户检索其密码。
MaxInvalidPasswordAttempts	获取在锁定成员资格用户之前允许的无效密码或密码答案尝试次数。
MinRequiredNonAlphanumericCharacters	获取有效密码中必须包含的最少特殊字符数。
MinRequiredPasswordLength	获取密码所需的最小长度。
Name	获得一个友好名称，用于在配置过程中引用提供程序。 (继承自 ProviderBase)
PasswordAttemptWindow	获取在锁定成员资格用户之前允许的最大无效密码或无效密码提示问题答案尝试次数的分钟数。
PasswordFormat	获取一个值，该值指示成员资格数据存储中存储密码的格式。
PasswordStrengthRegularExpression	获取用于计算密码的正则表达式。
RequiresQuestionAndAnswer	获取一个值，该值指示成员资格提供程序是否配置为要求用户在进行密码重置和检索时回答密码提示问题。
RequiresUniqueEmail	获取一个值，指示成员资格提供程序是否配置为要求每个用户名具有唯一的电子邮件地址。

方法

ChangePassword(String, String, String)	处理更新成员资格用户密码的请求。
ChangePasswordQuestionAndAnswer(String, String, String, String)	处理更新成员资格用户的密码提示问题和答案的请求。
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	将新的成员资格用户添加到数据源。
DecryptPassword(Byte[])	对加密的密码进行解密。
DeleteUser(String, Boolean)	从成员资格数据源中删除用户。
EncryptPassword(Byte[])	对密码进行加密。
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	使用指定的密码兼容性模式对指定密码进行加密。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
FindUsersByEmail(String, Int32, Int32, Int32)	获取成员资格用户集合，这些用户的电子邮件地址包含要匹配的指定电子邮件地址。
FindUsersByName(String, Int32, Int32, Int32)	获取一个成员资格用户的集合，其中的用户名包含要匹配的指定用户名。
GetAllUsers(Int32, Int32, Int32)	获取数据页中数据源的所有用户的集合。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetNumberOfUsersOnline()	获取当前正在访问应用程序的用户数。
GetPassword(String, String)	从数据源获取指定用户名所对应的密码。
GetType()	获取当前实例的 Type。 (继承自 Object)
GetUser(Object, Boolean)	根据成员资格用户的唯一标识符从数据源中获取用户信息。 提供一个选项用于更新用户的上一次活动日期/时间戳。
GetUser(String, Boolean)	从数据源为用户获取信息。 提供一个选项用于更新用户的上一次活动日期/时间戳。
GetUserNameByEmail(String)	获取与指定电子邮件地址关联的用户名。
Initialize(String, NameValueCollection)	初始化配置生成器。 (继承自 ProviderBase)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnValidatingPassword(ValidatePasswordEventArgs)	如果定义了事件处理程序，则引发 ValidatingPassword 事件。
ResetPassword(String, String)	将用户密码重置为自动生成的新密码。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
UnlockUser(String)	清除锁定，以便验证成员资格用户。
UpdateUser(MembershipUser)	更新数据源中有关用户的信息。
ValidateUser(String, String)	验证数据源中是否存在指定的用户名和密码。

事件

ValidatingPassword

在创建了用户、更改了密码或重置了密码时发生。

另请参阅

• 实现成员资格提供程序
• 成员资格简介