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

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > SqlMembershipProvider.CreateUser メソッドの意味・解説 
.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

SqlMembershipProvider.CreateUser メソッド

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

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

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

Visual Basic (宣言)
Public Overrides 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 SqlMembershipProvider
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 override 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
) override
J#
public 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

SQL Server データベース内のメンバシップ ユーザーを一意に識別する Guid。

status

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

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

解説解説

このメソッドは Membership クラスによって呼び出され、ASP.NET アプリケーションの構成ファイルに指定されている SQL Server データベースに新しいユーザーを作成します。

新しいユーザーは、構成されている ApplicationName で識別されます。

RequiresUniqueEmail プロパティに true が設定され、null 参照 (Visual Basic では Nothing) または空の文字列 ("") が email パラメータに指定されている場合、ユーザーの作成は失敗します。RequiresUniqueEmail プロパティに true が設定され、email パラメータの値が、構成されている ApplicationName のデータベース内の既存のユーザーの電子メール アドレスと同じだった場合も、ユーザーの作成は失敗します。

ユーザー名の最大長は 256 文字です。電子メール アドレスの最大長は 256 文字です。パスワードの最大長は、クリア テキストの場合でも、ハッシュまたは暗号化された後でも 128 文字です。

他にも、以下のような理由でユーザーの作成は失敗します。

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

使用例使用例

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

メモメモ

このサンプルは、Membership クラスを使用して、Web.config ファイルで defaultProvider として指定された SqlMembershipProvider を呼び出します。既定のプロバイダに SqlMembershipProvider 型としてアクセスする必要がある場合は、Membership クラスの Provider プロパティをキャストできます。固有のプロバイダの種類として構成されたその他のプロバイダにアクセスする場合、Membership クラスの Providers プロパティを使用して、参照されたプロバイダを固有プロバイダの種類としてキャストすることによって、構成された名前でアクセスできます。

Visual Basic
<%@ 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>
C#
<%@ 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>
プラットフォームプラットフォーム

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
参照参照
関連項目
SqlMembershipProvider クラス
SqlMembershipProvider メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要

急上昇のことば

S・A
日本の宇宙開発
メディカルサスペンション
辻沢杏子
.pm
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

SqlMembershipProvider.CreateUser メソッドのお隣キーワード

SqlInt64.Value プロパティ

SqlInt64.Xor メソッド

SqlInt64.Zero フィールド

SqlMembershipProvider.ApplicationName プロパティ

SqlMembershipProvider.ChangePassword メソッド

SqlMembershipProvider.ChangePasswordQuestionAndAnswer メソッド

SqlMembershipProvider.CreateUser メソッド

SqlMembershipProvider.DeleteUser メソッド

SqlMembershipProvider.EnablePasswordReset プロパティ

SqlMembershipProvider.EnablePasswordRetrieval プロパティ

SqlMembershipProvider.FindUsersByEmail メソッド

SqlMembershipProvider.FindUsersByName メソッド

SqlMembershipProvider.GeneratePassword メソッド

検索ランキング

   

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


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

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

©2024 GRAS Group, Inc.RSS