Sintaxis declarativa del control de servidor Web PasswordRecovery
Actualización: noviembre 2007
Proporciona elementos de interfaz de usuario que permiten a un usuario recuperar o restablecer una contraseña perdida y recibirla a través del correo electrónico.
<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>
Comentarios
El control PasswordRecovery ayuda a usuarios que han olvidado su contraseña. Permite a un usuario solicitar un mensaje de correo electrónico que contenga una contraseña nueva o que ya esté asociada a su nombre de usuario.
Nota El control PasswordRecovery utiliza los servicios de correo electrónico de Internet para enviar a los usuarios contraseñas nuevas o recuperadas. El envío de contraseñas por correo electrónico presenta riesgos para la seguridad. Deberá determinar si esos riesgos para la seguridad son aceptables.
Para obtener más información sobre el control PasswordRecovery y otros controles de inicio de sesión, vea Controles ASP.NET de inicio de sesión.
Ejemplo
En el ejemplo de código siguiente se muestra cómo se utiliza el control PasswordRecovery. Se definen controladores para los eventos Load y UserLookupError. La propiedad HelpPageUrl se establece en el archivo 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>