MembershipProvider.CreateUser メソッド

.NET Framework クラス ライブラリ リファレンス

MembershipProvider.CreateUser メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

新しいメンバシップ ユーザーをデータ ソースに追加します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Function
 CreateUser ( _
    username As String, _
    password As String, _
    email As String, _
    passwordQuestion As String, _
    passwordAnswer As String, _
    isApproved As Boolean, _
    providerUserKey As Object, _
    <OutAttribute> ByRef status As MembershipCreateStatus
 _
) As MembershipUser

Visual Basic (使用法)

Dim instance As MembershipProvider
Dim username As String
Dim password As String
Dim email As String
Dim passwordQuestion As String
Dim passwordAnswer As String
Dim isApproved As Boolean
Dim providerUserKey As Object
Dim status As MembershipCreateStatus
Dim returnValue As MembershipUser

returnValue = instance.CreateUser(username, password, email, passwordQuestion, passwordAnswer,
 isApproved, providerUserKey, status)

C#

public abstract MembershipUser CreateUser (
    string username,
    string password,
    string email,
    string passwordQuestion,
    string passwordAnswer,
    bool isApproved,
    Object providerUserKey,
    out MembershipCreateStatus status
)

C++

public:
virtual MembershipUser^ CreateUser (
    String^ username, 
    String^ password, 
    String^ email, 
    String^ passwordQuestion, 
    String^ passwordAnswer, 
    bool isApproved, 
    Object^ providerUserKey, 
    [OutAttribute] MembershipCreateStatus% status
) abstract

J#

public abstract MembershipUser CreateUser (
    String username, 
    String password, 
    String email, 
    String passwordQuestion, 
    String passwordAnswer, 
    boolean isApproved, 
    Object providerUserKey, 
    /** @attribute OutAttribute() */ /** @ref */ MembershipCreateStatus status
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

username

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

password

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

email

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

passwordQuestion

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

passwordAnswer

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

isApproved

新しいユーザーを承認するかどうか。

providerUserKey

メンバシップ データ ソースでのユーザーの一意の識別子。

status

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

戻り値
新しく作成されたユーザーの情報が格納された MembershipUser オブジェクト。

解説

新しいユーザーの名前、パスワード、および電子メール アドレスを入力値として受け取り、指定のアプリケーションに対して新しいユーザーをデータ ソースに作成します。CreateUser メソッドは、新しい作成されたユーザーの情報が格納された MembershipUser オブジェクトを返します。また、CreateUser メソッドは、ユーザーの作成が成功したか失敗したかを示す MembershipCreateStatus 値を返す out パラメータ (Visual Basic では ByRef を使用できます) も定義します。

CreateUser メソッドは、MembershipValidatePasswordEventHandler イベント ハンドラが指定されている場合、ValidatingPassword イベントを発生させ、そのイベントの結果に基づいてユーザーの作成アクションを続行またはキャンセルします。OnValidatingPassword 仮想メソッドを使用して、指定された MembershipValidatePasswordEventHandler イベント ハンドラを実行できます。

使用例

MembershipProvider 実装の例については、「プロファイル プロバイダの実装」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MembershipProvider クラス
MembershipProvider メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップ プロバイダの実装
メンバシップの概要