2.1.5.3 CreateUser

このメソッドは、データベースに新しいユーザーを追加します。

宣言

// C#
public override MembershipUser CreateUser(string userName, string password,
   string emailAddress, string passwordQuestion, string passwordAnswer, bool
   isApproved, Object providerUserKey, out MembershipCreateStatus status);

パラメータ

  • userName

    新しいユーザーのユーザー名。

  • password

    新しいユーザーのパスワード。

  • emailAddress

    新しいユーザーの電子メール・アドレス。

  • passwordQuestion

    新しいユーザーのパスワードに対する質問。

  • passwordAnswer

    新しいユーザーのパスワードに対する回答。

  • isApproved

    新しいユーザーが検証を承認されるかどうかを示すブール値。

  • providerUserKey

    データベースから取得される新しいユーザーの一意識別子。

  • status

    ユーザーが正常に作成されたかどうかを示すMembershipCreateStatus列挙値。

戻り値

新規に作成されたユーザーの情報が移入されるMembershipUserオブジェクト。

備考

このメソッドは、新規に作成されたユーザーの情報が移入されたMembershipUserオブジェクトを戻します。statusパラメータは、ユーザーが正常に作成されたかどうかを示すMembershipCreateStatus値を戻します。CreateUserメソッドに失敗した場合、MembershipCreateStatusメンバーは失敗の原因を示します。

MembershipCreateStatus列挙

MembershipCreateStatus列挙値を、表2-9にリストします。

表2-9 MembershipCreateStatus列挙値

メンバー名 説明

DuplicateEmail

アプリケーションの電子メール・アドレスがすでにデータベースに存在します。

DuplicateProviderUserKey

アプリケーションのプロバイダ・ユーザー・キーがすでにデータベースに存在します。

DuplicateUserName

アプリケーションのユーザー名がすでにデータベースに存在します。

InvalidAnswer

パスワードに対する回答が正しい形式ではありません。

InvalidEmail

電子メール・アドレスが正しい形式ではありません。

InvalidPassword

パスワードが正しい形式ではありません。

InvalidProviderUserKey

プロバイダ・ユーザー・キーが無効なタイプまたは形式です。

InvalidQuestion

パスワードに対する質問が正しい形式ではありません。

InvalidUserName

ユーザー名がデータベースに見つかりませんでした。

ProviderError

プロバイダにより、他のMembershipCreateStatus列挙値で説明されていないエラーが戻されました。

Success

ユーザーが正常に作成されました。

UserRejected

プロバイダ定義の理由により、ユーザーが作成されませんでした。