CreateUserAndAccount()
WebSecurity - CreateUserAndAccount()
定义
CreateUserAndAccount() 方法使用用户名和密码在用户数据库中创建一个新的帐户,并且可根据需要指定用户是否必须明确地确认帐户。
C# 和 VB 语法
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:
- 用户名为空
- 用户名已经有一个会员帐户
- 密码为空
- 密码太长
- 数据库操作失败
技术数据
名称 | 值 |
---|---|
Namespace | WebMatrix.WebData |
Assembly | WebMatrix.WebData.dll |