Membership.CreateUser メソッドとは? わかりやすく解説

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > Membership.CreateUser メソッドの意味・解説 

Membership.CreateUser メソッド (String, String, String, String, String, Boolean, MembershipCreateStatus)

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

プロパティ値を指定して新しユーザーデータ ストア追加しユーザー作成成功したかどうか、または失敗理由を示すステータス パラメータ返します

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

Public Shared Function CreateUser
 ( _
    username As String, _
    password As String, _
    email As String, _
    passwordQuestion As String, _
    passwordAnswer As String, _
    isApproved As Boolean, _
    <OutAttribute> ByRef status As MembershipCreateStatus
 _
) As MembershipUser
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 status As MembershipCreateStatus
Dim returnValue As MembershipUser

returnValue = Membership.CreateUser(username, password, email, passwordQuestion,
 passwordAnswer, isApproved, status)
public static MembershipUser CreateUser (
    string username,
    string password,
    string email,
    string passwordQuestion,
    string passwordAnswer,
    bool isApproved,
    out MembershipCreateStatus status
)
public:
static MembershipUser^ CreateUser (
    String^ username, 
    String^ password, 
    String^ email, 
    String^ passwordQuestion, 
    String^ passwordAnswer, 
    bool isApproved, 
    [OutAttribute] MembershipCreateStatus% status
)
public static MembershipUser CreateUser (
    String username, 
    String password, 
    String email, 
    String passwordQuestion, 
    String passwordAnswer, 
    boolean isApproved, 
    /** @attribute OutAttribute() */ /** @ref */ MembershipCreateStatus status
)
JScript では、値型引数参照渡しされません。

パラメータ

username

新しユーザーユーザー名

password

新規ユーザーパスワード

email

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

passwordQuestion

メンバシップ ユーザー対すパスワード質問

passwordAnswer

メンバシップ ユーザー対すパスワード解答

isApproved

新しユーザーログオン承認するかどうかを示すブール値。

status

ユーザー作成成功したかどうか、または失敗理由を示す MembershipCreateStatus。

戻り値
新しく作成されユーザーの MembershipUser オブジェクトユーザー作成されなかった場合、このメソッドnull 参照 (Visual Basic では Nothing) を返します

解説解説

CreateUser は、新しユーザーデータ ストア追加し新しく作成したユーザーMembershipUser オブジェクト返しますユーザー作成失敗した場合失敗理由を示す status 出力パラメータから MembershipCreateStatus 値を取得できます

CreateUser メソッドは、password空の文字列または null 参照 (Visual Basic では Nothing) の場合username空の文字列null 参照 (Visual Basic では Nothing)、またはコンマ (,) を含む場合passwordQuestionnull 参照 (Visual Basic では Nothing) でなく空の文字列である場合、または passwordAnswernull 参照 (Visual Basic では Nothing) でなく空の文字列である場合に、null 参照 (Visual Basic では Nothing) を返します

メンバシップ ユーザーがいったん作成され、そのユーザーMembershipUser オブジェクト参照できる状態になれば、MembershipUser パブリック メソッド使用して、そのユーザー設定変更できますまた、MembershipUser オブジェクトプロパティ値を設定してMembershipUser オブジェクトを UpdateUser メソッドに渡すことにより、ユーザー設定変更することもできます

アプリケーションデータ ソースユーザーが既に存在している場合、GetUser メソッド使用して既存ユーザーMembershipUser オブジェクト取得できます

すべての文字列パラメータ値について先頭末尾空白トリムされます

使用例使用例

フォーム認証ASP.NET メンバシップ使用するように構成されASP.NET アプリケーション新しユーザー作成するコード例次に示しますユーザー作成失敗した場合、そのユーザーに対してメッセージ表示されます。それ以外場合ユーザーアプリケーションログイン ページリダイレクトされます

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security"
 %>
<script runat="server">

Public Sub CreateUser_OnClick(sender As
 Object, args As EventArgs)

  ' Create new user and retrieve create status result.

  Dim status As MembershipCreateStatus
  Dim passwordQuestion As String
 = ""
  Dim passwordAnswer As String
 = ""

  If Membership.RequiresQuestionAndAnswer Then
    passwordQuestion = PasswordQuestionTextbox.Text
    passwordAnswer = PasswordAnswerTextbox.Text
  End If

  Try
    Dim newUser As MembershipUser = Membership.CreateUser(UsernameTextbox.Text,
 PasswordTextbox.Text, _
                                                   EmailTextbox.Text, passwordQuestion
,
 _
                                                   passwordAnswer, True,
 status)
    If newUser Is Nothing
 Then
      Msg.Text = GetErrorMessage(status)
    Else
       Response.Redirect("login.aspx")
    End If
  Catch
    Msg.Text = "An exception occurred creating the user."
  End Try

End Sub

Public Function GetErrorMessage(status As
 MembershipCreateStatus) As String

   Select Case status
   
      Case MembershipCreateStatus.DuplicateUserName:
        Return "Username already exists. Please
 enter a different user name."

      Case MembershipCreateStatus.DuplicateEmail:
        Return "A username for that e-mail
 address already exists. Please enter a different e-mail address."

      Case MembershipCreateStatus.InvalidPassword:
        Return "The password provided is invalid.
 Please enter a valid password value."

      Case MembershipCreateStatus.InvalidEmail:
        Return "The e-mail address provided
 is invalid. Please check the value and try again."

      Case MembershipCreateStatus.InvalidAnswer:
        Return "The password retrieval answer
 provided is invalid. Please check the value and try again."

      Case MembershipCreateStatus.InvalidQuestion:
        Return "The password retrieval question
 provided is invalid. Please check the value and try again."

      Case MembershipCreateStatus.InvalidUserName
        Return "The user name provided is invalid.
 Please check the value and try again."

      Case MembershipCreateStatus.ProviderError:
        Return "The authentication provider
 returned an error. Please verify your entry and try again. If the problem persists,
 please contact your system administrator."

      Case MembershipCreateStatus.UserRejected:
        Return "The user creation request has
 been canceled. Please verify your entry and try again. If the problem persists,
 please contact your system administrator."

      Case Else:
        Return "An unknown error occurred.
 Please verify your entry and try again. If the problem persists, please contact
 your system administrator."
   End Select

End Function

</script>

<html>
<head>
<title>Create User</title>
</head>
<body>

<form runat="server">
  <h3>Create New User</h3>
  <asp:Label id="Msg" ForeColor="maroon"
 runat="server" />
  <table CellPadding="3" border="0">
    <tr>
      <td>Username:</td>
      <td><asp:Textbox id="UsernameTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="UsernameRequiredValidator"
 runat="server"
                                      ControlToValidate="UserNameTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Password:</td>
      <td><asp:Textbox id="PasswordTextbox"
 runat="server" TextMode="Password"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Confirm Password:</td>
      <td><asp:Textbox id="PasswordConfirmTextbox"
 runat="server" TextMode="Password"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordConfirmRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" />
          <asp:CompareValidator id="PasswordConfirmCompareValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static"
 ControlToCompare="PasswordTextBox"
                                      ErrorMessage="Confirm password
 must match password." />
      </td>
    </tr>
    <tr>
      <td>Email Address:</td>
      <td><asp:Textbox id="EmailTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator"
 runat="server"
                                      ControlToValidate="EmailTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>


<% If Membership.RequiresQuestionAndAnswer Then
 %>

    <tr>
      <td>Password Question:</td>
      <td><asp:Textbox id="PasswordQuestionTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="PasswordQuestionRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordQuestionTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Password Answer:</td>
      <td><asp:Textbox id="PasswordAnswerTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="PasswordAnswerRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordAnswerTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>

<% End If %>


    <tr>
      <td></td>
      <td><asp:Button id="CreateUserButton"
 Text="Create User" OnClick="CreateUser_OnClick"
 runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">

public void CreateUser_OnClick(object sender,
 EventArgs args)
{
  // Create new user and retrieve create status result.

  MembershipCreateStatus status;
  string passwordQuestion = "";
  string passwordAnswer = "";

  if (Membership.RequiresQuestionAndAnswer)
  {
    passwordQuestion = PasswordQuestionTextbox.Text;
    passwordAnswer = PasswordAnswerTextbox.Text;
  }

  try
  {
    MembershipUser newUser = Membership.CreateUser(UsernameTextbox.Text, PasswordTextbox.Text,
 
                                                   EmailTextbox.Text, passwordQuestion
,
                                                   passwordAnswer, true,
 out status);
    if (newUser == null)
    {
      Msg.Text = GetErrorMessage(status);
    }
    else
    {
      Response.Redirect("login.aspx");
    }
  }
  catch
  {
    Msg.Text = "An exception occurred creating the user.";
  }
}

public string GetErrorMessage(MembershipCreateStatus
 status)
{
   switch (status)
   {
      case MembershipCreateStatus.DuplicateUserName:
        return "Username already exists. Please enter a different
 user name.";

      case MembershipCreateStatus.DuplicateEmail:
        return "A username for that e-mail
 address already exists. Please enter a different e-mail address.";

      case MembershipCreateStatus.InvalidPassword:
        return "The password provided is invalid. Please
 enter a valid password value.";

      case MembershipCreateStatus.InvalidEmail:
        return "The e-mail address provided is invalid. Please
 check the value and try again.";

      case MembershipCreateStatus.InvalidAnswer:
        return "The password retrieval answer provided is
 invalid. Please check the value and try again.";

      case MembershipCreateStatus.InvalidQuestion:
        return "The password retrieval question provided
 is invalid. Please check the value and try again.";

      case MembershipCreateStatus.InvalidUserName:
        return "The user name provided is invalid. Please
 check the value and try again.";

      case MembershipCreateStatus.ProviderError:
        return "The authentication provider returned an error.
 Please verify your entry and try again. If the problem persists,
 please contact your system administrator.";

      case MembershipCreateStatus.UserRejected:
        return "The user creation request has been canceled.
 Please verify your entry and try again. If the problem persists,
 please contact your system administrator.";

      default:
        return "An unknown error occurred. Please verify
 your entry and try again. If the problem persists, please contact
 your system administrator.";
   }
}

</script>

<html>
<head>
<title>Create User</title>
</head>
<body>

<form runat="server">
  <h3>Create New User</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server"
 /><BR>

  <table CellPadding="3" border="0">
    <tr>
      <td>Username:</td>
      <td><asp:Textbox id="UsernameTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="UsernameRequiredValidator"
 runat="server"
                                      ControlToValidate="UserNameTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Password:</td>
      <td><asp:Textbox id="PasswordTextbox" runat="server"
 TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Confirm Password:</td>
      <td><asp:Textbox id="PasswordConfirmTextbox" runat="server"
 TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordConfirmRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 />
          <asp:CompareValidator id="PasswordConfirmCompareValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static" ControlToCompare="PasswordTextBox"
                                      ErrorMessage="Confirm password must match
 password." />
      </td>
    </tr>
    <tr>
      <td>Email Address:</td>
      <td><asp:Textbox id="EmailTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator"
 runat="server"
                                      ControlToValidate="EmailTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>


<% if (Membership.RequiresQuestionAndAnswer) { %>

    <tr>
      <td>Password Question:</td>
      <td><asp:Textbox id="PasswordQuestionTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordQuestionRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordQuestionTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Password Answer:</td>
      <td><asp:Textbox id="PasswordAnswerTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordAnswerRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordAnswerTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>

<% } %>


    <tr>
      <td></td>
      <td><asp:Button id="CreateUserButton" Text="Create
 User" OnClick="CreateUser_OnClick" runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

Membership.CreateUser メソッド (String, String)

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

新しユーザーデータ ストア追加します

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

Public Shared Function CreateUser
 ( _
    username As String, _
    password As String _
) As MembershipUser
Dim username As String
Dim password As String
Dim returnValue As MembershipUser

returnValue = Membership.CreateUser(username, password)
public static MembershipUser CreateUser (
    string username,
    string password
)
public:
static MembershipUser^ CreateUser (
    String^ username, 
    String^ password
)
public static MembershipUser CreateUser (
    String username, 
    String password
)
public static function CreateUser
 (
    username : String, 
    password : String
) : MembershipUser

パラメータ

username

新しユーザーユーザー名

password

新規ユーザーパスワード

戻り値
新しく作成されユーザーの MembershipUser オブジェクト

例外例外
例外種類条件

MembershipCreateUserException

ユーザー作成されませんでしたStatusCode プロパティの MembershipCreateStatus 値を確認してください

解説解説

CreateUser は、新しユーザーデータ ストア追加し新しく作成したユーザーMembershipUser オブジェクト返しますユーザー作成失敗すると、MembershipCreateUserExceptionスローさます。ユーザー作成失敗した理由を示す MembershipCreateUserExceptionStatusCode プロパティから MembershipCreateStatus 値を取得できます

メンバシップ ユーザーがいったん作成され、そのユーザーMembershipUser オブジェクト参照できる状態になれば、RequiresQuestionAndAnswer が trueアプリケーション対する ChangePasswordQuestionAndAnswer などの MembershipUser パブリック メソッド使用して、そのユーザー設定変更できますまた、MembershipUser オブジェクトプロパティ値を設定して、これを UpdateUser メソッドに渡すことにより、ユーザー設定変更することもできます

アプリケーションデータ ソースユーザーが既に存在している場合、GetUser メソッド使用して既存ユーザーMembershipUser オブジェクト取得できます

SqlMembershipProvider では、オプションで、各ユーザーに対して一意電子メール アドレス要求できます。RequiresUniqueEmail プロパティtrue場合作成中ユーザーに対して電子メール アドレス指定できる CreateUser オーバーロード1 つ使用する必要がありますそれ以外場合は、MembershipCreateUserExceptionスローさます。

すべてのパラメータ値について先頭末尾空白トリムされます

使用例使用例

フォーム認証ASP.NET メンバシップ使用するように構成されASP.NET アプリケーション新しユーザー作成するコード例次に示しますユーザー作成失敗した場合、そのユーザーに対してメッセージ表示されます。それ以外場合ユーザーアプリケーションログイン ページリダイレクトされます

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security"
 %>
<script runat="server">

Public Sub CreateUser_OnClick(sender As
 Object, args As EventArgs)
  Try
    ' Create new user.

    Dim newUser As MembershipUser = Membership.CreateUser(UsernameTextbox.Text,
 PasswordTextbox.Text)


    ' If user created successfully, set password question and answer
 (if applicable) and 
    ' redirect to login page. Otherwise Return an error message.

    If Membership.RequiresQuestionAndAnswer Then
    
      newUser.ChangePasswordQuestionAndAnswer(PasswordTextbox.Text, _
                                              PasswordQuestionTextbox.Text, _
                                              PasswordAnswerTextbox.Text)
    End If

    Response.Redirect("login.aspx")
  Catch e As MembershipCreateUserException
    Msg.Text = GetErrorMessage(e.StatusCode)
  Catch e As HttpException
    Msg.Text = e.Message
  End Try
End Sub

Public Function GetErrorMessage(status As
 MembershipCreateStatus) As String

   Select Case status
      Case MembershipCreateStatus.DuplicateUserName
        Return "Username already exists. Please
 enter a different user name."

      Case MembershipCreateStatus.DuplicateEmail
        Return "A username for that e-mail
 address already exists. Please enter a different e-mail address."

      Case MembershipCreateStatus.InvalidPassword
        Return "The password provided is invalid.
 Please enter a valid password value."

      Case MembershipCreateStatus.InvalidEmail
        Return "The e-mail address provided
 is invalid. Please check the value and try again."

      Case MembershipCreateStatus.InvalidAnswer
        Return "The password retrieval answer
 provided is invalid. Please check the value and try again."

      Case MembershipCreateStatus.InvalidQuestion
        Return "The password retrieval question
 provided is invalid. Please check the value and try again."

      Case MembershipCreateStatus.InvalidUserName
        Return "The user name provided is invalid.
 Please check the value and try again."

      Case MembershipCreateStatus.ProviderError
        Return "The authentication provider
 Returned an error. Please verify your entry and try again. If the problem persists,
 please contact your system administrator."

      Case MembershipCreateStatus.UserRejected
        Return "The user creation request has
 been canceled. Please verify your entry and try again. If the problem persists,
 please contact your system administrator."

      Case Else
        Return "An unknown error occurred.
 Please verify your entry and try again. If the problem persists, please contact
 your system administrator."
   End Select
End Function

</script>

<html>
<head>
<title>Create User</title>
</head>
<body>

<form runat="server">
  <h3>Create New User</h3>

  <asp:Label id="Msg" ForeColor="maroon"
 runat="server" /><BR>

  <table CellPadding="3" border="0">
    <tr>
      <td>Username:</td>
      <td><asp:Textbox id="UsernameTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="UsernameRequiredValidator"
 runat="server"
                                      ControlToValidate="UserNameTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Password:</td>
      <td><asp:Textbox id="PasswordTextbox"
 runat="server" TextMode="Password"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Confirm Password:</td>
      <td><asp:Textbox id="PasswordConfirmTextbox"
 runat="server" TextMode="Password"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordConfirmRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" />
          <asp:CompareValidator id="PasswordConfirmCompareValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static"
 ControlToCompare="PasswordTextBox"
                                      ErrorMessage="Confirm password
 must match password." />
      </td>
    </tr>


<% If Membership.RequiresQuestionAndAnswer Then
 %>

    <tr>
      <td>Password Question:</td>
      <td><asp:Textbox id="PasswordQuestionTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="PasswordQuestionRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordQuestionTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Password Answer:</td>
      <td><asp:Textbox id="PasswordAnswerTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="PasswordAnswerRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordAnswerTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>

<% End If %>


    <tr>
      <td></td>
      <td><asp:Button id="CreateUserButton"
 Text="Create User" OnClick="CreateUser_OnClick"
 runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">

public void CreateUser_OnClick(object sender,
 EventArgs args)
{
  try
  {
    // Create new user.

    MembershipUser newUser = Membership.CreateUser(UsernameTextbox.Text, PasswordTextbox.Text);


    // If user created successfully, set password question and answer
 (if applicable) and 
    // redirect to login page. Otherwise return an error message.

    if (Membership.RequiresQuestionAndAnswer)
    {
      newUser.ChangePasswordQuestionAndAnswer(PasswordTextbox.Text,
                                              PasswordQuestionTextbox.Text,
                                              PasswordAnswerTextbox.Text);
    }

    Response.Redirect("login.aspx");
  }
  catch (MembershipCreateUserException e)
  {
    Msg.Text = GetErrorMessage(e.StatusCode);
  }
  catch (HttpException e)
  {
    Msg.Text = e.Message;
  }
}

public string GetErrorMessage(MembershipCreateStatus
 status)
{
   switch (status)
   {
      case MembershipCreateStatus.DuplicateUserName:
        return "Username already exists. Please enter a different
 user name.";

      case MembershipCreateStatus.DuplicateEmail:
        return "A username for that e-mail
 address already exists. Please enter a different e-mail address.";

      case MembershipCreateStatus.InvalidPassword:
        return "The password provided is invalid. Please
 enter a valid password value.";

      case MembershipCreateStatus.InvalidEmail:
        return "The e-mail address provided is invalid. Please
 check the value and try again.";

      case MembershipCreateStatus.InvalidAnswer:
        return "The password retrieval answer provided is
 invalid. Please check the value and try again.";

      case MembershipCreateStatus.InvalidQuestion:
        return "The password retrieval question provided
 is invalid. Please check the value and try again.";

      case MembershipCreateStatus.InvalidUserName:
        return "The user name provided is invalid. Please
 check the value and try again.";

      case MembershipCreateStatus.ProviderError:
        return "The authentication provider returned an error.
 Please verify your entry and try again. If the problem persists,
 please contact your system administrator.";

      case MembershipCreateStatus.UserRejected:
        return "The user creation request has been canceled.
 Please verify your entry and try again. If the problem persists,
 please contact your system administrator.";

      default:
        return "An unknown error occurred. Please verify
 your entry and try again. If the problem persists, please contact
 your system administrator.";
   }
}

</script>

<html>
<head>
<title>Create User</title>
</head>
<body>

<form runat="server">
  <h3>Create New User</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server"
 /><BR>

  <table CellPadding="3" border="0">
    <tr>
      <td>Username:</td>
      <td><asp:Textbox id="UsernameTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="UsernameRequiredValidator"
 runat="server"
                                      ControlToValidate="UserNameTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Password:</td>
      <td><asp:Textbox id="PasswordTextbox" runat="server"
 TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Confirm Password:</td>
      <td><asp:Textbox id="PasswordConfirmTextbox" runat="server"
 TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordConfirmRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 />
          <asp:CompareValidator id="PasswordConfirmCompareValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static" ControlToCompare="PasswordTextBox"
                                      ErrorMessage="Confirm password must match
 password." />
      </td>
    </tr>


<% if (Membership.RequiresQuestionAndAnswer) { %>

    <tr>
      <td>Password Question:</td>
      <td><asp:Textbox id="PasswordQuestionTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordQuestionRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordQuestionTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Password Answer:</td>
      <td><asp:Textbox id="PasswordAnswerTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordAnswerRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordAnswerTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>

<% } %>


    <tr>
      <td></td>
      <td><asp:Button id="CreateUserButton" Text="Create
 User" OnClick="CreateUser_OnClick" runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

Membership.CreateUser メソッド (String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

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

指定したプロパティ値と一意ID新しユーザーデータ ストア追加しユーザー作成成功したかどうか、または失敗理由を示すステータス パラメータ返します

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

Public Shared 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
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 = Membership.CreateUser(username, password, email, passwordQuestion,
 passwordAnswer, isApproved, providerUserKey, status)
public static MembershipUser CreateUser (
    string username,
    string password,
    string email,
    string passwordQuestion,
    string passwordAnswer,
    bool isApproved,
    Object providerUserKey,
    out MembershipCreateStatus status
)
public:
static MembershipUser^ CreateUser (
    String^ username, 
    String^ password, 
    String^ email, 
    String^ passwordQuestion, 
    String^ passwordAnswer, 
    bool isApproved, 
    Object^ providerUserKey, 
    [OutAttribute] MembershipCreateStatus% status
)
public static MembershipUser CreateUser (
    String username, 
    String password, 
    String email, 
    String passwordQuestion, 
    String passwordAnswer, 
    boolean isApproved, 
    Object providerUserKey, 
    /** @attribute OutAttribute() */ /** @ref */ MembershipCreateStatus status
)
JScript では、値型引数参照渡しされません。

パラメータ

username

新しユーザーユーザー名

password

新規ユーザーパスワード

email

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

passwordQuestion

メンバシップ ユーザー対すパスワード質問

passwordAnswer

メンバシップ ユーザー対すパスワード解答

isApproved

新しユーザーログオン承認するかどうかを示すブール値。

providerUserKey

メンバシップ データ ストア格納する必要があるユーザーユーザー ID

status

ユーザー作成成功したかどうか、または失敗理由を示す MembershipCreateStatus。

戻り値
新しく作成されユーザーの MembershipUser オブジェクトユーザー作成されなかった場合、このメソッドnull 参照 (Visual Basic では Nothing) を返します

解説解説

CreateUser は、新しユーザーデータ ストア追加し新しく作成したユーザーMembershipUser オブジェクト返しますユーザー作成失敗した場合失敗理由を示す status 出力パラメータから MembershipCreateStatus 値を取得できますproviderUserKey パラメータ使用してデータベース主キー値など、ユーザー一意ID指定できます

CreateUser メソッドは、password空の文字列または null 参照 (Visual Basic では Nothing) の場合username空の文字列null 参照 (Visual Basic では Nothing)、またはコンマ (,) を含む場合passwordQuestionnull 参照 (Visual Basic では Nothing) でなく空の文字列である場合、または passwordAnswernull 参照 (Visual Basic では Nothing) でなく空の文字列である場合に、null 参照 (Visual Basic では Nothing) を返します

メンバシップ ユーザーがいったん作成され、そのユーザーMembershipUser オブジェクト参照できる状態になれば、MembershipUser パブリック メソッド使用して、そのユーザー設定変更できますまた、MembershipUser オブジェクトプロパティ値を設定してMembershipUser オブジェクトを UpdateUser メソッドに渡すことにより、ユーザー設定変更することもできます

アプリケーションデータ ソースユーザーが既に存在している場合、GetUser メソッド使用して既存ユーザーMembershipUser オブジェクト取得できます

すべての文字列パラメータ値について先頭末尾空白トリムされます

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

Membership.CreateUser メソッド


Membership.CreateUser メソッド (String, String, String)

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

電子メール アドレス指定して新しユーザーデータ ストア追加します

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

例外例外
例外種類条件

MembershipCreateUserException

ユーザー作成されませんでしたStatusCode プロパティの MembershipCreateStatus 値を確認してください

解説解説

CreateUser は、新しユーザーデータ ストア追加し新しく作成したユーザーMembershipUser オブジェクト返しますユーザー作成失敗すると、MembershipCreateUserExceptionスローさます。ユーザー作成失敗した理由を示す MembershipCreateUserExceptionStatusCode プロパティから MembershipCreateStatus 値を取得できます

メンバシップ ユーザーがいったん作成され、そのユーザーMembershipUser オブジェクト参照できる状態になれば、RequiresQuestionAndAnswer が trueアプリケーション対する ChangePasswordQuestionAndAnswer などの MembershipUser パブリック メソッド使用して、そのユーザー設定変更できますまた、MembershipUser オブジェクトプロパティ値を設定して、これを UpdateUser メソッドに渡すことにより、ユーザー設定変更することもできます

アプリケーションデータ ソースユーザーが既に存在している場合、GetUser メソッド使用して既存ユーザーMembershipUser オブジェクト取得できます

すべてのパラメータ値について先頭末尾空白トリムされます

使用例使用例

フォーム認証ASP.NET メンバシップ使用するように構成されASP.NET アプリケーション新しユーザー作成するコード例次に示しますユーザー作成失敗した場合、そのユーザーに対してメッセージ表示されます。それ以外場合ユーザーアプリケーションログイン ページリダイレクトされます

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security"
 %>
<script runat="server">

Public Sub CreateUser_OnClick(sender As
 Object, args As EventArgs)
  Dim result As MembershipCreateStatus
  Try
    ' Create new user.

    Dim newUser As MembershipUser
    If Membership.RequiresQuestionAndAnswer Then
      newUser  = Membership.CreateUser( _
        UsernameTextbox.Text, _
        PasswordTextbox.Text, _
        EmailTextbox.Text, _
        PasswordQuestionTextbox.Text, _
        PasswordAnswerTextbox.Text, _
        false, _
        result)
    Else
      newUser  = Membership.CreateUser( _
        UsernameTextbox.Text, _
        PasswordTextbox.Text, _
        EmailTextbox.Text)
    End If

    Response.Redirect("login.aspx")

  Catch e As MembershipCreateUserException
    Msg.Text = GetErrorMessage(e.StatusCode)
  Catch e As HttpException
    Msg.Text = e.Message
  End Try
End Sub

Public Function GetErrorMessage(status As
 MembershipCreateStatus) As String

   Select Case status
      Case MembershipCreateStatus.DuplicateUserName
        Return "Username already exists. Please
 enter a different user name."

      Case MembershipCreateStatus.DuplicateEmail
        Return "A username for that e-mail
 address already exists. Please enter a different e-mail address."

      Case MembershipCreateStatus.InvalidPassword
        Return "The password provided is invalid.
 Please enter a valid password value."

      Case MembershipCreateStatus.InvalidEmail
        Return "The e-mail address provided
 is invalid. Please check the value and try again."

      Case MembershipCreateStatus.InvalidAnswer
        Return "The password retrieval answer
 provided is invalid. Please check the value and try again."

      Case MembershipCreateStatus.InvalidQuestion
        Return "The password retrieval question
 provided is invalid. Please check the value and try again."

      Case MembershipCreateStatus.InvalidUserName
        Return "The user name provided is invalid.
 Please check the value and try again."

      Case MembershipCreateStatus.ProviderError
        Return "The authentication provider
 Returned an error. Please verify your entry and try again. If the problem persists,
 please contact your system administrator."

      Case MembershipCreateStatus.UserRejected
        Return "The user creation request has
 been canceled. Please verify your entry and try again. If the problem persists,
 please contact your system administrator."

      Case Else
        Return "An unknown error occurred.
 Please verify your entry and try again. If the problem persists, please contact
 your system administrator."
   End Select
End Function

</script>

<html>
<head>
<title>Create User</title>
</head>
<body>

<form runat="server">
  <h3>Create New User</h3>

  <asp:Label id="Msg" ForeColor="maroon"
 runat="server" /><BR>

  <table CellPadding="3" border="0">
    <tr>
      <td>Username:</td>
      <td><asp:Textbox id="UsernameTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="UsernameRequiredValidator"
 runat="server"
                                      ControlToValidate="UserNameTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Password:</td>
      <td><asp:Textbox id="PasswordTextbox"
 runat="server" TextMode="Password"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Confirm Password:</td>
      <td><asp:Textbox id="PasswordConfirmTextbox"
 runat="server" TextMode="Password"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordConfirmRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" />
          <asp:CompareValidator id="PasswordConfirmCompareValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static"
 ControlToCompare="PasswordTextBox"
                                      ErrorMessage="Confirm password
 must match password." />
      </td>
    </tr>
    <tr>
      <td>Email Address:</td>
      <td><asp:Textbox id="EmailTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator"
 runat="server"
                                      ControlToValidate="EmailTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>


<% If Membership.RequiresQuestionAndAnswer Then
 %>

    <tr>
      <td>Password Question:</td>
      <td><asp:Textbox id="PasswordQuestionTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="PasswordQuestionRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordQuestionTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Password Answer:</td>
      <td><asp:Textbox id="PasswordAnswerTextbox"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="PasswordAnswerRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordAnswerTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>

<% End If %>


    <tr>
      <td></td>
      <td><asp:Button id="CreateUserButton"
 Text="Create User" OnClick="CreateUser_OnClick"
 runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">

public void CreateUser_OnClick(object sender,
 EventArgs args)
{
  MembershipCreateStatus result;

  try
  {
    // Create new user.

    if (Membership.RequiresQuestionAndAnswer)
    {
      MembershipUser newUser = Membership.CreateUser(
        UsernameTextbox.Text, 
        PasswordTextbox.Text, 
        EmailTextbox.Text,
        PasswordQuestionTextbox.Text,
        PasswordAnswerTextbox.Text,
        false,
        out result);
    }
    else 
    {
      MembershipUser newUser = Membership.CreateUser(
        UsernameTextbox.Text, 
        PasswordTextbox.Text, 
        EmailTextbox.Text);
    }

    Response.Redirect("login.aspx");
  }
  catch (MembershipCreateUserException e)
  {
    Msg.Text = GetErrorMessage(e.StatusCode);
  }
  catch (HttpException e)
  {
    Msg.Text = e.Message;
  }
}

public string GetErrorMessage(MembershipCreateStatus
 status)
{
   switch (status)
   {
      case MembershipCreateStatus.DuplicateUserName:
        return "Username already exists. Please enter a different
 user name.";

      case MembershipCreateStatus.DuplicateEmail:
        return "A username for that e-mail
 address already exists. Please enter a different e-mail address.";

      case MembershipCreateStatus.InvalidPassword:
        return "The password provided is invalid. Please
 enter a valid password value.";

      case MembershipCreateStatus.InvalidEmail:
        return "The e-mail address provided is invalid. Please
 check the value and try again.";

      case MembershipCreateStatus.InvalidAnswer:
        return "The password retrieval answer provided is
 invalid. Please check the value and try again.";

      case MembershipCreateStatus.InvalidQuestion:
        return "The password retrieval question provided
 is invalid. Please check the value and try again.";

      case MembershipCreateStatus.InvalidUserName:
        return "The user name provided is invalid. Please
 check the value and try again.";

      case MembershipCreateStatus.ProviderError:
        return "The authentication provider returned an error.
 Please verify your entry and try again. If the problem persists,
 please contact your system administrator.";

      case MembershipCreateStatus.UserRejected:
        return "The user creation request has been canceled.
 Please verify your entry and try again. If the problem persists,
 please contact your system administrator.";

      default:
        return "An unknown error occurred. Please verify
 your entry and try again. If the problem persists, please contact
 your system administrator.";
   }
}

</script>

<html>
<head>
<title>Create User</title>
</head>
<body>

<form runat="server">
  <h3>Create New User</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server"
 /><BR>

  <table CellPadding="3" border="0">
    <tr>
      <td>Username:</td>
      <td><asp:Textbox id="UsernameTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="UsernameRequiredValidator"
 runat="server"
                                      ControlToValidate="UserNameTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Password:</td>
      <td><asp:Textbox id="PasswordTextbox" runat="server"
 TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Confirm Password:</td>
      <td><asp:Textbox id="PasswordConfirmTextbox" runat="server"
 TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordConfirmRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 />
          <asp:CompareValidator id="PasswordConfirmCompareValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static" ControlToCompare="PasswordTextBox"
                                      ErrorMessage="Confirm password must match
 password." />
      </td>
    </tr>
    <tr>
      <td>Email Address:</td>
      <td><asp:Textbox id="EmailTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator"
 runat="server"
                                      ControlToValidate="EmailTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>


<% if (Membership.RequiresQuestionAndAnswer) { %>

    <tr>
      <td>Password Question:</td>
      <td><asp:Textbox id="PasswordQuestionTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordQuestionRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordQuestionTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Password Answer:</td>
      <td><asp:Textbox id="PasswordAnswerTextbox" runat="server"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordAnswerRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordAnswerTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>

<% } %>


    <tr>
      <td></td>
      <td><asp:Button id="CreateUserButton" Text="Create
 User" OnClick="CreateUser_OnClick" runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「Membership.CreateUser メソッド」の関連用語

Membership.CreateUser メソッドのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



Membership.CreateUser メソッドのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2024 Microsoft.All rights reserved.

©2024 GRAS Group, Inc.RSS