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 對象