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 Identity取代。 强烈建议更新应用以使用 ASP.NET 标识平台而不是成员身份提供程序。

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

注释

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

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

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

• 你需要将成员身份信息存储在.NET框架中包含的成员资格提供程序不支持的数据源中，例如 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[], MembershipPasswordCompatibilityMode)	使用指定的密码兼容性模式加密指定的密码。
EncryptPassword(Byte[])	加密密码。
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	创建用户、更改密码或重置密码时发生。

另请参阅

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