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