WebSecurity - CreateUserAndAccount()
❮ WebSecurity
Definition(定义)
CreateUserAndAccount() 方法创建一个新的用户账户到用户数据库中,使用用户名和密码,并且可以选择指定用户是否必须明确确认账户。
C# 和 VB 语法
WebSecurity.CreateUserAndAccount(username, password, propertyValues, requireConfirmation)
参数
参数 | 类型 | 描述 |
---|---|---|
userName | 字符串 | 用户名 |
password | 字符串 | 用户密码 |
propertyValues | 对象 | 一个包含其他用户属性的字典 |
requireConfirmation | 布尔值 | 如果账户必须通过返回的 token 进行确认,则为 true,默认为 false。 |
返回值
类型 | 描述 |
---|---|
字符串 | 一个可以发送给用户的用于确认账户的 token。 |
备注
CreateUserAndAccount() 方法会在 WebSecurity 数据库中创建用户配置文件表中的新条目,然后创建成员资格表中的相应条目。
您可以为 requireConfirmationToken 参数传递 true,以要求用户账户必须由用户确认。要确认账户,您需要获取 CreateUserAndAccount() 方法返回的 token。
如果您正在手动维护用户配置文件表,并且只想为用户创建成员资格表条目,请改用 CreateAccount() 方法。
错误和异常
如果以下任一情况发生,则对 WebSecurity 对象的任何访问都会引发 InvalidOperationException:
- 尚未调用 InitializeDatabaseConnection() 方法
- SimpleMembership 未初始化(或在网站配置中禁用)
如果发生以下情况,CreateUserAndAccount() 方法还会抛出 MembershipCreateUserException:
- 用户名为空
- 用户名已具有成员资格账户
- 密码为空
- 密码过长
- 数据库操作失败
❮ WebSecurity