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 |
