WebSecurity - CreateUserAndAccount()
WebSecurity 对象 CreateUserAndAccount() 方法使用用户名和密码在用户数据库中创建一个新的帐户,并且可根据需要指定用户是否必须明确地确认帐户
语法
WebSecurity.CreateUserAndAccount( username, password, propertyValues, requireConfirmation)
参数
参数 | 类型 | 描述 |
---|---|---|
userName | String | 用户名 |
password | String | 用户密码 |
propertyValues | Object | 一个包含额外的用户属性的字典 |
requireConfirmation | Boolean | 如果账户必须使用令牌返回值进行确认,则返回 true 默认返回 false |
返回值
类型 | 描述 |
---|---|
String | 可发送给用户进行帐户确认的令牌 |
备注
CreateUserAndAccount() 方法在 WebSecurity 数据库中的用户资料表中创建一个新的入口,然后在会员表中创建一个匹配的入口
我们可以为 requireConfirmationToken 参数传递 true 来要求用帐户必须经过用户确认
如需确认帐户,则必须从 CreateUserAndAccount() 方法获得令牌作为返回值
如果想手动维护用户资料表,并且只想为用户创建会员表入口,请调用 CreateAccount() 方法
错误和异常
在下面的情况下,任何对 WebSecurity 对象的访问将抛出一个 InvalidOperationException 异常
- InitializeDatabaseConnection() 方法没有被调用
- SimpleMembership 没有初始化(或者在网站配置中禁用)
在下面的情况下, CreateUserAndAccount() 方法也抛出一个 MembershipCreateUserException 异常
- 用户名为空
- 用户名已经有一个会员帐户
- 密码为空
- 密码太长
- 数据库操作失败
命名空间
WebMatrix.WebData
Assembly
WebMatrix.WebData.dll