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