Latest web development tutorials

WebSecurity CreateUserAndAccount 方法

WebSecurity 對象 WebSecurity對象

定義

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


WebSecurity 對象 WebSecurity對象