PasswordRecovery Web 伺服器控制項宣告式語法
更新：2007 年 11 月
提供使用者介面項目，可以讓使用者復原或重設遺失的密碼，並透過電子郵件接收。
<asp:PasswordRecovery AccessKey="string" AnswerLabelText="string" AnswerRequiredErrorMessage="string" BackColor="color name|#dddddd" BorderColor="color name|#dddddd" BorderPadding="integer" BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge| Inset|Outset" BorderWidth="size" CssClass="string" Enabled="True|False" EnableTheming="True|False" EnableViewState="True|False" Font-Bold="True|False" Font-Italic="True|False" Font-Names="string" Font-Overline="True|False" Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium| Large|X-Large|XX-Large" Font-Strikeout="True|False" Font-Underline="True|False" ForeColor="color name|#dddddd" GeneralFailureText="string" Height="size" HelpPageIconUrl="uri" HelpPageText="string" HelpPageUrl="uri" ID="string" MailDefinition-BodyFileName="uri" MailDefinition-CC="string" MailDefinition-From="string" MailDefinition-IsBodyHtml="True|False" MailDefinition-Priority="Normal|Low|High" MailDefinition-Subject="string" MembershipProvider="string" OnAnswerLookupError="AnswerLookupError event handler" OnDataBinding="DataBinding event handler" OnDisposed="Disposed event handler" OnInit="Init event handler" OnLoad="Load event handler" OnPreRender="PreRender event handler" OnSendingMail="SendingMail event handler" OnSendMailError="SendMailError event handler" OnUnload="Unload event handler" OnUserLookupError="UserLookupError event handler" OnVerifyingAnswer="VerifyingAnswer event handler" OnVerifyingUser="VerifyingUser event handler" QuestionFailureText="string" QuestionInstructionText="string" QuestionLabelText="string" QuestionTitleText="string" runat="server" SkinID="string" Style="string" SubmitButtonImageUrl="uri" SubmitButtonText="string" SubmitButtonType="Button|Image|Link" SuccessPageUrl="uri" SuccessText="string" TabIndex="integer" TextLayout="TextOnLeft|TextOnTop" ToolTip="string" UserName="string" UserNameFailureText="string" UserNameInstructionText="string" UserNameLabelText="string" UserNameRequiredErrorMessage="string" UserNameTitleText="string" Visible="True|False" Width="size" > <FailureTextStyle /> <HyperLinkStyle /> <InstructionTextStyle /> <LabelStyle /> <MailDefinition BodyFileName="uri" CC="string" From="string" IsBodyHtml="True|False" Priority="Normal|Low|High" Subject="string" > <EmbeddedObjects> <asp:EmbeddedMailObject Name="string" Path="uri" /> </EmbeddedObjects> </MailDefinition> <QuestionTemplate> <!-- child controls --> </QuestionTemplate> <SubmitButtonStyle /> <SuccessTemplate> <!-- child controls --> </SuccessTemplate> <SuccessTextStyle /> <TextBoxStyle /> <TitleTextStyle /> <UserNameTemplate> <!-- child controls --> </UserNameTemplate> <ValidatorTextStyle /> </asp:PasswordRecovery>
備註
PasswordRecovery 控制項可以協助那些遺忘了密碼的使用者。它可讓使用者要求包含新密碼或已與其使用者名稱關聯之密碼的電子郵件訊息。
注意：PasswordRecovery 控制項會使用網際網路電子郵件服務，將復原的或新密碼傳送給使用者。透過電子郵件傳送密碼存在固有的安全性風險。您應該判斷是否能接受這些安全性風險。
如需 PasswordRecovery 控制項和其他登入控制項的詳細資訊，請參閱ASP.NET 登入控制項。
範例
下列程式碼範例將示範如何使用 PasswordRecovery 控制項。Load 和 UserLookupError 事件的處理常式已定義。HelpPageUrl 屬性設定為 recoveryHelp.aspx 檔案。
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
' Set the field label background color if the user name is not found.
Sub PasswordRecovery1_UserLookupError(ByVal sender As Object, ByVal e As System.EventArgs)
PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Red
End Sub
' Reset the field label background color.
Sub PasswordRecovery1_Load(ByVal sender As Object, ByVal e As System.EventArgs)
PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Black
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:PasswordRecovery id="PasswordRecovery1" runat="server" BorderStyle="Solid" BorderWidth="1px" BackColor="#F7F7DE"
Font-Size="10pt" Font-Names="Verdana" BorderColor="#CCCC99" HelpPageText="Need help?" HelpPageUrl="recoveryHelp.aspx" onuserlookuperror="PasswordRecovery1_UserLookupError" onload="PasswordRecovery1_Load" >
<successtemplate>
<table border="0" style="font-size:10pt;">
<tr>
<td>Your password has been sent to you.</td>
</tr>
</table>
</successtemplate>
<titletextstyle font-bold="True" forecolor="White" backcolor="#6B696B">
</titletextstyle>
</asp:PasswordRecovery>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
// Set the field label background color if the user name is not found.
void PasswordRecovery1_UserLookupError(object sender, System.EventArgs e)
{
PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Red;
}
// Reset the field label background color.
void PasswordRecovery1_Load(object sender, System.EventArgs e)
{
PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Black;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:PasswordRecovery id="PasswordRecovery1" runat="server" BorderStyle="Solid" BorderWidth="1px" BackColor="#F7F7DE"
Font-Size="10pt" Font-Names="Verdana" BorderColor="#CCCC99" HelpPageText="Need help?" HelpPageUrl="recoveryHelp.aspx" onuserlookuperror="PasswordRecovery1_UserLookupError" onload="PasswordRecovery1_Load" >
<successtemplate>
<table border="0" style="font-size:10pt;">
<tr>
<td>Your password has been sent to you.</td>
</tr>
</table>
</successtemplate>
<titletextstyle font-bold="True" forecolor="White" backcolor="#6B696B">
</titletextstyle>
</asp:PasswordRecovery>
</form>
</body>
</html>