WebSecurity- CreateUserAndAccount()
❮WebSecurity
意味
CreateUserAndAccount ()メソッドは、ユーザー名とパスワードを使用してユーザーデータベースに新しいアカウントを作成し、オプションで、ユーザーがアカウントを明示的に確認する必要があるかどうかを指定できます。
C#およびVB構文
WebSecurity.CreateUserAndAccount(username,
password, propertyValues, requireConfirmation)
パラメーター
Parameter | Type | Description |
---|---|---|
userName | String | The user name |
password | String | The user password |
propertyValues | Object | A dictionary that contains additional user attributes |
requireConfirmation | Boolean | true if the account must be confirmed using the token return value, default is false. |
戻り値
Type | Description |
---|---|
String | A token that can be sent to the user to confirm the account. |
備考
CreateUserAndAccount()メソッドは、ユーザープロファイルテーブルに新しいエントリを作成し、次にWebSecurityデータベースのメンバーシップテーブルに対応するエントリを 作成します。
requireConfirmationTokenパラメーターにtrueを渡し て、ユーザーがユーザーアカウントを確認する必要があることを要求できます。 アカウントを確認するには、 CreateUserAndAccount()メソッドからの戻り値としてトークンを取得します。
ユーザープロファイルテーブルを手動で管理していて、ユーザーのメンバーシップテーブルエントリのみを作成する場合は、代わりにCreateAccount() メソッドを呼び出します。
エラーと例外
次の場合、 WebSecurityオブジェクトにアクセスすると、 InvalidOperationExceptionがスローされます。
- InitializeDatabaseConnection()メソッドが呼び出されていません
- SimpleMembershipが初期化されていない(またはWebサイト構成で無効になっている)
CreateUserAndAccount()メソッドは、次の場合にもMembershipCreateUserExceptionをスローします。
- ユーザー名は空です
- ユーザー名にはすでにメンバーシップアカウントがあります
- パスワードが空です
- パスワードが長すぎます
- データベース操作が失敗しました
❮WebSecurity