WebSecurity - CreateUserAndAccount()
❮ WebSecurity
Definition(定義)
CreateUserAndAccount() 方法建立一個新的使用者賬戶到使用者資料庫中,使用使用者名稱和密碼,並且可以選擇指定使用者是否必須明確確認賬戶。
C# 和 VB 語法
WebSecurity.CreateUserAndAccount(username, password, propertyValues, requireConfirmation)
引數
引數 | 型別 | 描述 |
---|---|---|
userName | 字串 | 使用者名稱 |
password | 字串 | 使用者密碼 |
propertyValues | 物件 | 一個包含其他使用者屬性的字典 |
requireConfirmation | 布林值 | 如果賬戶必須透過返回的 token 進行確認,則為 true,預設為 false。 |
返回值
型別 | 描述 |
---|---|
字串 | 一個可以傳送給使用者的用於確認賬戶的 token。 |
備註
CreateUserAndAccount() 方法會在 WebSecurity 資料庫中建立使用者配置檔案表中的新條目,然後建立成員資格表中的相應條目。
您可以為 requireConfirmationToken 引數傳遞 true,以要求使用者賬戶必須由使用者確認。要確認賬戶,您需要獲取 CreateUserAndAccount() 方法返回的 token。
如果您正在手動維護使用者配置檔案表,並且只想為使用者建立成員資格表條目,請改用 CreateAccount() 方法。
錯誤和異常
如果以下任一情況發生,則對 WebSecurity 物件的任何訪問都會引發 InvalidOperationException:
- 尚未呼叫 InitializeDatabaseConnection() 方法
- SimpleMembership 未初始化(或在網站配置中停用)
如果發生以下情況,CreateUserAndAccount() 方法還會丟擲 MembershipCreateUserException:
- 使用者名稱為空
- 使用者名稱已具有成員資格賬戶
- 密碼為空
- 密碼過長
- 資料庫操作失敗
❮ WebSecurity