CreateUserWizard クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説CreateUserWizard コントロールは、Web サイトのユーザー データ ストアと通信してデータ ストア内に新しいユーザー アカウントを作成する MembershipProvider オブジェクト用のユーザー インターフェイスを提供します。CreateUserWizard は MembershipProvider に依存してユーザーを作成し、必要に応じて無効化します。
既定では、CreateUserWizard コントロールは Web サイトの訪問者からユーザー名とパスワードを受け入れます。サイトの MembershipProvider オブジェクトの要件に基づいて、CreateUserWizard コントロールは、Email プロパティによって表される電子メール アドレスと、Question および Answer によって表されるパスワード復元のための確認用の質問と答えをオプションで受け入れます。CreateUserWizard の必須コントロールと省略可能なコントロールの一覧表については、「CreateUserStep」を参照してください。
.gif) 重要 : |
|---|
| AutoGeneratePassword が true に設定され、アプリケーションの Web.config ファイルで PasswordStrengthRegularExpression プロパティが設定されている場合、正規表現の強度テストに合格しないパスワードが生成される可能性があります。この場合、ユーザーを作成すると、無効なパスワードを示すエラーが発生します。 |
ユーザーの作成
CreateUserWizard でユーザーが作成されると、コントロールは現在の MembershipProvider と対話して、次のタスクを順番に実行します。
フィールドを追加するか、指定された CreateUserStep プロパティおよび CompleteStep プロパティの前または後に追加ステップを追加して、追加情報を受け入れるよう CreateUserWizard コントロールを拡張できます。
| メモ |
|---|
| CreateUserWizardStep ステップは CreateUserWizard コントロール内の最初のステップであり、必須ステップです。既定では、ユーザーが CreateUserWizardStep ステップに戻り、同じ資格情報を使用して別のユーザー アカウントを誤って作成しないように、AllowReturn プロパティは false に設定されています。EnableViewState が false に設定されている場合、AllowReturn プロパティはビューステートで保持されないため、AllowReturn 値を保持するためのロジックをアプリケーションに含める必要があります。 |
UserName など、テキスト ボックスで表される CreateUserWizard コントロールの各プロパティは、ページの有効期間のすべてのフェーズでアクセスできます。コントロールは、テキスト ボックスが発生させる TextChanged イベントによって、エンド ユーザーが加えた変更を検出します。
電子メールを送信するための SMTP メール サーバーが設定済みの場合、CreateUserWizard コントロールは、オプションで新規ユーザーに電子メール メッセージを送信できます。詳細については、MailDefinition プロパティのトピックを参照してください。
スタイルとテンプレート
CreateUserWizard コントロールがテンプレートでカスタマイズされていない場合、CreateUserWizard コントロールの AccessKey プロパティは、コントロール内の最初のテキスト ボックスと、コントロールのすべてのテキスト ボックスに適用される TabIndex プロパティに適用されます。CreateUserWizard コントロールがテンプレートでカスタマイズされている場合、AccessKey プロパティと TabIndex プロパティは無視されます。この場合は、各テンプレートの子コントロールの AccessKey プロパティと TabIndex プロパティを直接設定します。
UserName や Password など、テキスト ボックスで表される CreateUserWizard コントロールの各プロパティは、ページの有効期間のすべてのフェーズでアクセスできます。このコントロールは、テキストボックスによって発生した TextChanged イベントを使用してエンド ユーザーが行った変更をピック アップします。
| メモ |
|---|
| AutoGeneratePassword、MembershipProvider、または RequireEmail のいずれかのプロパティを設定すると、CreateUserWizard コントロールの子コントロールが再作成され、そのコントロールの状態はプロセス中に失われます。この状況を回避するには、CreateUserWizard コントロールの子コントロールの状態を明示的に保持するか、コントロールをテンプレートの内部に入れないようにします。 |
CreateUserWizard コントロールのスタイル プロパティの一覧と、各スタイル プロパティが影響を及ぼす UI 要素の説明を以下の表に示します。各スタイルが適用されるプロパティの一覧については、個々のスタイル プロパティのドキュメントを参照してください。
| ContinueButtonStyle | |
| CreateUserButtonStyle | |
| HyperLinkStyle | 他のページへのリンク。 |
| InstructionTextStyle | |
| LabelStyle | |
| TextBoxStyle | |
| TitleTextStyle | |
| CompleteSuccessTextStyle | |
| ErrorMessageStyle | |
| PasswordHintStyle | |
| ValidatorTextStyle |
CreateUserWizard コントロールは、CreateUserWizard コントロールと同じページ上の他のフィールドを別々に検証できるように、検証グループを使用します。既定では、CreateUserWizard コントロールの ID プロパティが、検証グループの名前として使用されます。たとえば、ID が "CreateUserWizard1" の CreateUserWizard コントロールは、検証グループ名 "CreateUserWizard1" を使用します。CreateUserWizard コントロールが所属する検証グループを設定する場合は、コントロールのテンプレートを作成してから、検証グループ名を変更する必要があります。
CreateUserWizard クラスは、非標準モードまたは互換捻出モードにおける Microsoft Internet Explorer での特別なレンダリングをサポートしていない Wizard から継承します。CreateUserWizard では、非標準の Internet Explorer モード用にレンダリングが最適化されません。CreateUserWizard コントロールを使用して Internet Explorer での最適なレンダリングを実現するには、既定で Visual Web Developer および Visual Studio に追加されている XHTML ドキュメント タイプを使用します。
このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。
使用例基本フォームで CreateUserWizard コントロールを使用する方法を最初のコード例に示します。このページでは、サイトの既定の MembershipProvider オブジェクトを使用して新しい Web サイト ユーザー アカウントが作成されます。
<%@ page language="VB"%> <script runat="server"> </script> <html> <head runat="server"> <title>CreateUserWizard basic sample</title> </head> <body> <form id="form1" runat="server"> <div> <asp:createuserwizard id="Createuserwizard1" runat="server" > </asp:createuserwizard> </div> </form> </body> </html>
<%@ page language="C#"%> <script runat="server"> </script> <html> <head runat="server"> <title>CreateUserWizard basic sample</title> </head> <body> <form id="form1" runat="server"> <div> <asp:createuserwizard id="Createuserwizard1" runat="server" > </asp:createuserwizard> </div> </form> </body> </html>
既定のテンプレートと共に CreateUserWizard コントロールを使用する方法を 2 番目のコード例に示します。
<%@ page language="VB"%> <script runat="server"> </script> <html> <head runat="server"> <title>CreateUserWizard sample</title> </head> <body> <form id="form1" runat="server"> <div> <asp:createuserwizard id="Createuserwizard1" runat="server"> <wizardsteps> <asp:createuserwizardstep runat="server" title="Sign Up for Your New Account"> <contenttemplate> <table border="0"> <tr> <td> <table border="0" style="height: 100%; width: 100%;"> <tr> <td align="center" colspan="2"> Sign Up for Your New Account</td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="UserName" id="UserNameLabel"> User Name:</asp:label></td> <td> <asp:textbox runat="server" id="UserName"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="UserName" tooltip="User Name is required." id="UserNameRequired" validationgroup="Createuserwizard1" errormessage="User Name is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="Password" id="PasswordLabel"> Password:</asp:label></td> <td> <asp:textbox runat="server" textmode="Password" id="Password"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="Password" tooltip="Password is required." id="PasswordRequired" validationgroup="Createuserwizard1" errormessage="Password is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="ConfirmPassword" id="ConfirmPasswordLabel"> Confirm Password:</asp:label></td> <td> <asp:textbox runat="server" textmode="Password" id="ConfirmPassword"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="ConfirmPassword" tooltip="Confirm Password is required." id="ConfirmPasswordRequired" validationgroup="Createuserwizard1" errormessage="Confirm Password is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="Email" id="EmailLabel"> Email:</asp:label></td> <td> <asp:textbox runat="server" id="Email"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="Email" tooltip="Email is required." id="EmailRequired" validationgroup="Createuserwizard1" errormessage="Email is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="Question" id="QuestionLabel"> Security Question:</asp:label></td> <td> <asp:textbox runat="server" id="Question"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="Question" tooltip="Security question is required." id="QuestionRequired" validationgroup="Createuserwizard1" errormessage="Security question is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="Answer" id="AnswerLabel"> Security Answer:</asp:label></td> <td> <asp:textbox runat="server" id="Answer"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="Answer" tooltip="Security answer is required." id="AnswerRequired" validationgroup="Createuserwizard1" errormessage="Security answer is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="center" colspan="2"> <asp:comparevalidator runat="server" display="Dynamic" errormessage="The Password and Confirmation Password must match." controltocompare="ConfirmPassword" controltovalidate="Password" id="PasswordCompare" validationgroup="Createuserwizard1"> </asp:comparevalidator> </td> </tr> <tr> <td align="center" colspan="2" style="color: Red;"> <asp:literal runat="server" enableviewstate="False" id="FailureText"> </asp:literal> </td> </tr> </table> </td> </tr> </table> </contenttemplate> </asp:createuserwizardstep> <asp:completewizardstep runat="server" title="Complete"> <contenttemplate> <table border="0"> <tr> <td> <table border="0" style="height: 100%; width: 100%;"> <tr> <td align="center" colspan="2"> Complete</td> </tr> <tr> <td> Your account has been successfully created.</td> </tr> <tr> <td align="right" colspan="2"> <asp:button runat="server" validationgroup="Createuserwizard1" commandname="Continue" id="ContinueButton" causesvalidation="False" text="Continue" /> </td> </tr> </table> </td> </tr> </table> </contenttemplate> </asp:completewizardstep> </wizardsteps> </asp:createuserwizard> </div> </form> </body> </html>
<%@ page language="C#"%> <script runat="server"> </script> <html> <head runat="server"> <title>CreateUserWizard Sample</title> </head> <body> <form id="form1" runat="server"> <div> <asp:createuserwizard id="Createuserwizard1" runat="server"> <wizardsteps> <asp:createuserwizardstep runat="server" title="Sign Up for Your New Account"> <contenttemplate> <table border="0"> <tr> <td> <table border="0" style="height: 100%; width: 100%;"> <tr> <td align="center" colspan="2"> Sign Up for Your New Account</td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="UserName" id="UserNameLabel"> User Name:</asp:label></td> <td> <asp:textbox runat="server" id="UserName"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="UserName" tooltip="User Name is required." id="UserNameRequired" validationgroup="Createuserwizard1" errormessage="User Name is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="Password" id="PasswordLabel"> Password:</asp:label></td> <td> <asp:textbox runat="server" textmode="Password" id="Password"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="Password" tooltip="Password is required." id="PasswordRequired" validationgroup="Createuserwizard1" errormessage="Password is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="ConfirmPassword" id="ConfirmPasswordLabel"> Confirm Password:</asp:label></td> <td> <asp:textbox runat="server" textmode="Password" id="ConfirmPassword"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="ConfirmPassword" tooltip="Confirm Password is required." id="ConfirmPasswordRequired" validationgroup="Createuserwizard1" errormessage="Confirm Password is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="Email" id="EmailLabel"> Email:</asp:label></td> <td> <asp:textbox runat="server" id="Email"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="Email" tooltip="Email is required." id="EmailRequired" validationgroup="Createuserwizard1" errormessage="Email is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="Question" id="QuestionLabel"> Security Question:</asp:label></td> <td> <asp:textbox runat="server" id="Question"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="Question" tooltip="Security question is required." id="QuestionRequired" validationgroup="Createuserwizard1" errormessage="Security question is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="right"> <asp:label runat="server" associatedcontrolid="Answer" id="AnswerLabel"> Security Answer:</asp:label></td> <td> <asp:textbox runat="server" id="Answer"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="Answer" tooltip="Security answer is required." id="AnswerRequired" validationgroup="Createuserwizard1" errormessage="Security answer is required."> *</asp:requiredfieldvalidator> </td> </tr> <tr> <td align="center" colspan="2"> <asp:comparevalidator runat="server" display="Dynamic" errormessage="The Password and Confirmation Password must match." controltocompare="ConfirmPassword" controltovalidate="Password" id="PasswordCompare" validationgroup="Createuserwizard1"> </asp:comparevalidator> </td> </tr> <tr> <td align="center" colspan="2" style="color: Red;"> <asp:literal runat="server" enableviewstate="False" id="FailureText"> </asp:literal> </td> </tr> </table> </td> </tr> </table> </contenttemplate> </asp:createuserwizardstep> <asp:completewizardstep runat="server" title="Complete"> <contenttemplate> <table border="0"> <tr> <td> <table border="0" style="height: 100%; width: 100%;"> <tr> <td align="center" colspan="2"> Complete</td> </tr> <tr> <td> Your account has been successfully created.</td> </tr> <tr> <td align="right" colspan="2"> <asp:button runat="server" validationgroup="Createuserwizard1" commandname="Continue" id="ContinueButton" causesvalidation="False" text="Continue" /> </td> </tr> </table> </td> </tr> </table> </contenttemplate> </asp:completewizardstep> </wizardsteps> </asp:createuserwizard> </div> </form> </body> </html>
3 番目のコード例では、CreateUserWizard コントロールに追加ステップを追加し、CreatedUser イベントを使用してユーザーの姓と名をパーソナル化プロパティに格納します。このコード例では、Web.config ファイルに次のエントリが必要です。
<profile>
</properties>
</profile>
</system.web>
</configuration>
<%@ page language="VB"%> <script runat="server"> Sub CreateUserWizard1_CreatedUser(ByVal sender As Object, ByVal e As System.EventArgs) Profile.SetPropertyValue("UserName", firstName.Text & " " & lastName.Text) End Sub </script> <html> <head runat="server"> <title> CreateUserWizard.CreatedUser sample</title> </head> <body> <form id="form1" runat="server"> <div> <asp:createuserwizard id="CreateUserWizard1" runat="server" oncreateduser="CreateUserWizard1_CreatedUser"> <wizardsteps> <asp:wizardstep runat="server" steptype="Start" title="Identification"> Tell us your name:<br /> <table width="100%"> <tr> <td> First name:</td> <td> <asp:textbox id="firstName" runat="server" /></td> </tr> <tr> <td> Last name:</td> <td> <asp:textbox id="lastName" runat="server" /></td> </tr> </table> </asp:wizardstep> <asp:createuserwizardstep runat="server" title="Sign Up for Your New Account"> </asp:createuserwizardstep> </wizardsteps> </asp:createuserwizard> </div> </form> </body> </html>
<%@ page language="C#"%> <script runat="server"> void CreateUserWizard1_CreatedUser(object sender, EventArgs e) { Profile.SetPropertyValue("UserName",firstName.Text + " " + lastName.Text); } </script> <html> <head runat="server"> <title> CreateUserWizard.CreatedUser sample</title> </head> <body> <form id="form1" runat="server"> <div> <asp:createuserwizard id="CreateUserWizard1" runat="server"> <wizardsteps> <asp:wizardstep runat="server" steptype="Start" title="Identification"> Tell us your name:<br /> <table width="100%"> <tr> <td> First name:</td> <td> <asp:textbox id="firstName" runat="server" /></td> </tr> <tr> <td> Last name:</td> <td> <asp:textbox id="lastName" runat="server" /></td> </tr> </table> </asp:wizardstep> <asp:createuserwizardstep runat="server" title="Sign Up for Your New Account"> </asp:createuserwizardstep> </wizardsteps> </asp:createuserwizard> </div> </form> </body> </html>
.NET Framework のセキュリティ継承階層System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.CompositeControl
System.Web.UI.WebControls.Wizard
System.Web.UI.WebControls.CreateUserWizard
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- CreateUserWizard クラスのページへのリンク
