PasswordRecovery.UserNameTemplate プロパティ
メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。 PasswordRecovery コントロールのユーザー名ビューを表示するために使用するテンプレートを取得または設定します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
プロパティ値
ユーザー名ビューに PasswordRecovery コントロールを表示するためのテンプレートを格納している ITemplate。既定値は null 参照 (Visual Basic では Nothing) です。
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文<TemplateContainerAttribute(GetType(PasswordRecovery))> _ Public Overridable Property UserNameTemplate As ITemplate
Dim instance As PasswordRecovery Dim value As ITemplate value = instance.UserNameTemplate instance.UserNameTemplate = value
[TemplateContainerAttribute(typeof(PasswordRecovery))] public virtual ITemplate UserNameTemplate { get; set; }
[TemplateContainerAttribute(typeof(PasswordRecovery))] public: virtual property ITemplate^ UserNameTemplate { ITemplate^ get (); void set (ITemplate^ value); }
/** @property */ public ITemplate get_UserNameTemplate () /** @property */ public void set_UserNameTemplate (ITemplate value)
public function get UserNameTemplate () : ITemplate public function set UserNameTemplate (value : ITemplate)
ユーザー名ビューに PasswordRecovery コントロールを表示するためのテンプレートを格納している ITemplate。既定値は null 参照 (Visual Basic では Nothing) です。
解説UserNameTemplate プロパティには、ユーザー名ビューの PasswordRecovery コントロールの外観を定義するテンプレートが格納されます。
ユーザー名ビューのテンプレートで使用する必須コントロールと省略可能なコントロールを次の表に示します。
Submit コントロールには、Button、LinkButton、ImageButton など、イベント バブルを発生させるコントロールを指定できます。コントロールの CommandName プロパティは、"Submit" に設定する必要があります。
ユーザー名ビューに必須コントロールが含まれていない場合、PasswordRecovery コントロールは HttpException 例外をスローします。省略可能なコントロールの ID に正しくない型のコントロールを設定しても例外はスローされません。しかし、以後そのコントロールは PasswordRecovery コントロールに無視されます。
テンプレートを使用してユーザー名ビューの外観を定義した場合、次のプロパティだけがコントロールの動作に影響します。
-
WebControl から継承したすべてのプロパティ (PasswordRecovery コントロール メンバの一覧を参照)
-
GeneralFailureText.
-
MailDefinition.
-
MembershipProvider.
-
SuccessPageUrl.
-
SuccessTemplate.
-
UserName.
-
UserNameFailureText.
PasswordRecovery コントロールのユーザー名ビューにテンプレートを使用した場合、他のすべてのプロパティは無効になります。
使用例UserNameTemplate プロパティを使用して、ログイン情報を格納するドメインをユーザーが選択できるようにする、PasswordRecovery コントロールのユーザー名ビューのテンプレートを定義するコード例を次に示します。
<%@ page language="VB" %> <script runat="server"> Sub PasswordRecovery1_VerifyingUser(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LoginCancelEventArgs) Dim provider as DropDownList provider = CType(PasswordRecovery1.FindControl("LoginProvider") ,DropDownList) PasswordRecovery1.MembershipProvider = provider.SelectedValue If PasswordRecovery1.MembershipProvider <> "Default" Then PasswordRecovery1.UserName = String.Format("{1}\\{0}", _ PasswordRecovery1.MembershipProvider, PasswordRecovery1.UserName) End If End Sub Sub PasswordRecovery1_VerifyingAnswer(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LoginCancelEventArgs) PasswordRecovery1.UserName = String.Format("{1}\\{0}", _ PasswordRecovery1.MembershipProvider, PasswordRecovery1.UserName) End Sub </script> <html> <body> <form runat="server"> <asp:passwordrecovery id="PasswordRecovery1" runat="server" onverifyinguser="PasswordRecovery1_VerifyingUser" onverifyinganswer="PasswordRecovery1_VerifyingAnswer"> <usernametemplate> <table border="0"> <tr> <td align="Center" colspan="2">Forgot Your Password?</td> </tr> <tr> <td align="Center" colspan="2">Enter your User Name to receive your password.</td> </tr> <tr> <td>Log in domain:</td> <td> <asp:dropdownlist id="LoginProvider" runat="server"> <asp:listitem value="Default">Default</asp:listitem> <asp:listitem value="Administration">Administration</asp:listitem> <asp:listitem value="Editorial">Editorial</asp:listitem> <asp:listitem value="Finance">Finance</asp:listitem> <asp:listitem value="Marketing">Marketing</asp:listitem> </asp:dropdownlist> </td> </tr> <tr> <td align="Right">User Name:</td> <td> <asp:textbox runat="server" id="UserName"> </asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="UserName" errormessage="User Name." id="UserNameRequired"> * </asp:requiredfieldvalidator> </td> </tr> <tr> <td align="Right" colspan="2"> <asp:button runat="server" commandname="Submit" text="Submit" id="Button"> </asp:button> </td> </tr> <tr> <td colspan="2" style="color:Red;"> <asp:literal runat="server" id="FailureText"></asp:literal> </td> </tr> </table> </usernametemplate> </asp:passwordrecovery> </form> </body> </html>
<%@ page language="C#" %> <script runat="server"> void PasswordRecovery1_VerifyingUser(Object sender, System.Web.UI.WebControls.LoginCancelEventArgs e) { DropDownList provider = ((DropDownList)PasswordRecovery1.FindControl("LoginProvider")); PasswordRecovery1.MembershipProvider = provider.SelectedValue; if (PasswordRecovery1.MembershipProvider != "Default") { PasswordRecovery1.UserName = String.Format("{0}\\{1}", PasswordRecovery1.MembershipProvider, PasswordRecovery1.UserName); } } void PasswordRecovery1_VerifyingAnswer(Object sender, System.Web.UI.WebControls.LoginCancelEventArgs e) { PasswordRecovery1.UserName = String.Format("{0}\\{1}", PasswordRecovery1.MembershipProvider, PasswordRecovery1.UserName); } </script> <html> <body> <form runat="server"> <asp:passwordrecovery id="PasswordRecovery1" runat="server" onverifyinguser="PasswordRecovery1_VerifyingUser" onverifyinganswer="PasswordRecovery1_VerifyingAnswer"> <usernametemplate> <table border="0"> <tr> <td align="Center" colspan="2">Forgot Your Password?</td> </tr> <tr> <td align="Center" colspan="2">Enter your User Name to receive your password.</td> </tr> <tr> <td>Log in domain:</td> <td> <asp:dropdownlist id="LoginProvider" runat="server"> <asp:listitem value="Default">Default</asp:listitem> <asp:listitem value="Administration">Administration</asp:listitem> <asp:listitem value="Editorial">Editorial</asp:listitem> <asp:listitem value="Finance">Finance</asp:listitem> <asp:listitem value="Marketing">Marketing</asp:listitem> </asp:dropdownlist> </td> </tr> <tr> <td align="Right">User Name:</td> <td> <asp:textbox runat="server" id="UserName"></asp:textbox> <asp:requiredfieldvalidator runat="server" controltovalidate="UserName" errormessage="User Name." id="UserNameRequired"> * </asp:requiredfieldvalidator> </td> </tr> <tr> <td align="Right" colspan="2"> <asp:button runat="server" commandname="Submit" text="Submit" id="Button"> </asp:button> </td> </tr> <tr> <td colspan="2" style="color:Red;"> <asp:literal runat="server" id="FailureText"></asp:literal> </td> </tr> </table> </usernametemplate> </asp:passwordrecovery> </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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- PasswordRecovery.UserNameTemplate プロパティのページへのリンク
