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