PasswordRecovery Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica elementos de la interfaz de usuario que permiten a un usuario recuperar o restablecer una contraseña perdida, y recibirla por correo electrónico.
public ref class PasswordRecovery : System::Web::UI::WebControls::CompositeControl[System.ComponentModel.Bindable(false)]
public class PasswordRecovery : System.Web.UI.WebControls.CompositeControl[<System.ComponentModel.Bindable(false)>]
type PasswordRecovery = class
inherit CompositeControlPublic Class PasswordRecovery
Inherits CompositeControl- Herencia
- Atributos
Ejemplos
En el ejemplo de código siguiente se muestra el uso del PasswordRecovery control .
<%@ 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>
<%@ 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>
Comentarios
En este tema:
Introducción
El PasswordRecovery control ayuda a los usuarios que han olvidado sus contraseñas. Permite al usuario solicitar un mensaje de correo electrónico que contenga una nueva contraseña o la contraseña ya asociada a su nombre de usuario.
Nota
El PasswordRecovery control web usa servicios de correo electrónico de Internet para enviar contraseñas recuperadas o nuevas a los usuarios. Hay riesgos de seguridad inherentes con el envío de contraseñas por correo electrónico. Debe determinar si estos riesgos de seguridad son aceptables para su sitio.
Nota
Si no está familiarizado con el conjunto de controles de inicio de sesión disponibles en ASP.NET, consulte ASP.NET Información general sobre los controles de inicio de sesión antes de continuar. Para obtener una lista de otros temas relacionados con los controles de inicio de sesión y la pertenencia, consulte Administración de usuarios mediante pertenencia.
Los usuarios solo pueden recuperar contraseñas cuando el proveedor de pertenencia definido en la MembershipProvider propiedad admite contraseñas cifradas o texto no cifrado. Dado que las contraseñas con hash no se pueden recuperar, los usuarios de sitios que usan contraseñas con hash solo pueden restablecer sus contraseñas.
Importante
Aceptar la entrada del usuario es una amenaza de seguridad potencial. Los usuarios malintencionados pueden enviar datos destinados a exponer vulnerabilidades o ejecutar programas que intenten generar contraseñas. Para mejorar la seguridad al trabajar con la entrada del usuario, debe usar las características de validación del control y proteger los proveedores de datos configurados para el control. Para obtener más información, consulte Protección de controles de inicio de sesión, Prácticas de seguridad básicas para aplicaciones web y Protección de la pertenencia.
Nota
El PasswordRecovery control se puede usar cuando no se ha aprobado un usuario de pertenencia (MembershipUser.IsApproved se establece falseen ), pero no se puede usar cuando se ha bloqueado un usuario de pertenencia (MembershipUser.IsLockedOut se establece trueen ).
El mensaje de correo electrónico se envía mediante la MailDefinition clase . Para poder enviar correo electrónico a los usuarios, debe configurar un servidor de correo en el archivo Web.config de la aplicación. Puede cambiar el contenido del correo electrónico enviado a los usuarios estableciendo un mensaje personalizado en la MailDefinition propiedad .
Nota
No es posible garantizar que un usuario reciba o vea un mensaje de correo electrónico. Para comprobar que un usuario ha recibido una notificación por correo electrónico, considere la posibilidad de proporcionar un vínculo de confirmación en el mensaje, lo que permite al usuario confirmar que se recibió la notificación.
Vistas
El PasswordRecovery control tiene tres estados o vistas:
Vista UserName: pide al usuario su nombre de usuario registrado.
Vista de preguntas: requiere que el usuario proporcione la respuesta a una pregunta almacenada para restablecer la contraseña.
Vista correcta: indica al usuario si la recuperación de contraseñas o el restablecimiento se han realizado correctamente.
El PasswordRecovery control muestra la vista Pregunta solo cuando el proveedor de pertenencia definido en la MembershipProvider propiedad admite preguntas y respuestas con contraseña.
En la tabla siguiente se muestra cada propiedad de estilo del PasswordRecovery control e indica qué vista afecta.
| Propiedad | Vista UserName | Vista de preguntas | Vista correcta |
|---|---|---|---|
| SubmitButtonStyle | Sí | Sí | Sí |
| FailureTextStyle | Sí | Sí | No |
| HyperLinkStyle | Sí | Sí | No |
| InstructionTextStyle | Sí | Sí | No |
| LabelStyle | Sí | Sí | No |
| SuccessTextStyle | No | No | Sí |
| TextBoxStyle | Sí | Sí | No |
| TitleTextStyle | Sí | Sí | Sí |
Estilos y plantillas
Puede usar un amplio conjunto de propiedades de estilo para personalizar la apariencia del PasswordRecovery control. Como alternativa, puede aplicar plantillas personalizadas a las tres vistas si necesita un control completo sobre la apariencia del control. Puede usar las QuestionTemplatepropiedades , SuccessTemplate y UserNameTemplate para crear plantillas para estas vistas. Si define una plantilla para una vista, las propiedades de estilo de PasswordRecovery no tienen ningún efecto.
En la tabla siguiente se enumeran las propiedades de PasswordRecovery estilo de control y se explica qué elemento de interfaz de usuario afecta a cada propiedad de estilo. Para obtener una lista de las propiedades a las que se aplica cada estilo, consulte la documentación de las propiedades de estilo individuales.
| Style (propiedad) | Elemento de interfaz de usuario afectado |
|---|---|
| SubmitButtonStyle | Envíe botones en todas las vistas. |
| FailureTextStyle | Texto de error que se muestra al usuario. |
| HyperLinkStyle | Vínculos a otras páginas. |
| InstructionTextStyle | Texto informativo en la página que indica a los usuarios cómo usar el control. |
| LabelStyle | Etiquetas para todos los campos de entrada, como cuadros de texto. |
| TextBoxStyle | Campos de entrada de texto. |
| TitleTextStyle | Texto del título para cada vista. |
| SuccessTextStyle | Texto que se muestra al usuario cuando la recuperación o el intento de restablecimiento de contraseña se realiza correctamente. |
En la tabla siguiente se enumeran las propiedades de plantilla que se aplican a cada vista del PasswordRecovery control . Para obtener una lista de los controles que debe establecer en cada plantilla, consulte la documentación de las propiedades de plantilla individuales.
| Ver | Propiedad Template |
|---|---|
| UserName | UserNameTemplate |
| Pregunta | QuestionTemplate |
| Correcto | SuccessTemplate |
Cuando el PasswordRecovery control no está personalizado con plantillas, la AccessKey propiedad del PasswordRecovery control se aplica al primer cuadro de texto del control y a la TabIndex propiedad , que se aplica a todos los cuadros de texto del control. Si el PasswordRecovery control se personaliza con plantillas, la AccessKey propiedad y la TabIndex propiedad se omiten. En este caso, establezca la AccessKey propiedad y la TabIndex propiedad de cada control secundario de plantilla directamente.
PasswordRecovery Las propiedades de control representadas por cuadros de texto, como Answer y Question, son accesibles durante todas las fases del ciclo de vida de la página. El control recogerá los cambios realizados por el usuario final mediante el TextChanged evento desencadenado por los cuadros de texto.
Agrupaciones de validación
El PasswordRecovery control crea un grupo de validación para todos los validadores de campo necesarios en el control para que otros controles de entrada de la página no se vean afectados al validar el PasswordRecovery control. De forma predeterminada, la ID propiedad del PasswordRecovery control se usa como nombre del grupo de validación. Por ejemplo, un PasswordRecovery control con el identificador "PasswordRecovery1" usará un nombre de grupo de validación de "PasswordRecovery1". Si desea que el PasswordRecovery control participe en otro grupo de validación, debe crear una plantilla para el control.
Aplicación de estilos CSS
El PasswordRecovery control permite especificar reglas de estilo CSS en el marcado. Si usa plantillas para personalizar la apariencia del PasswordRecovery control, puede especificar estilos CSS en el marcado de las plantillas. En ese caso, no se requiere ninguna tabla externa adicional. Puede impedir que la tabla se represente estableciendo la RenderOuterTable propiedad en false.
Accesibilidad
Para obtener información sobre cómo configurar este control para que genere marcado que se ajuste a los estándares de accesibilidad, vea Accesibilidad en Visual Studio y ASP.NET y ASP.NET Controles y accesibilidad.
Sintaxis declarativa
<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>
Constructores
| PasswordRecovery() |
Inicializa una nueva instancia de la clase PasswordRecovery. |
Campos
| SubmitButtonCommandName |
Representa el comando que se ejecuta cuando se hace clic en el botón Enviar. |
Propiedades
| AccessKey |
Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web. (Heredado de WebControl) |
| Adapter |
Obtiene el adaptador específico del explorador para el control. (Heredado de Control) |
| Answer |
Obtiene la respuesta a la pregunta de confirmación de recuperación de contraseña escrita por el usuario. |
| AnswerLabelText |
Obtiene o establece el texto de la etiqueta del cuadro de texto de respuesta de confirmación de la contraseña. |
| AnswerRequiredErrorMessage |
Obtiene o establece el mensaje de error que se muestra al usuario cuando el cuadro de texto Respuesta está en blanco. |
| AppRelativeTemplateSourceDirectory |
Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Heredado de Control) |
| Attributes |
Obtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control. (Heredado de WebControl) |
| BackColor |
Obtiene o establece el color de fondo del control de servidor web. (Heredado de WebControl) |
| BindingContainer |
Obtiene el control que contiene el enlace de datos de este control. (Heredado de Control) |
| BorderColor |
Obtiene o establece el color de borde del control Web. (Heredado de WebControl) |
| BorderPadding |
Obtiene o establece la cantidad de relleno dentro de los bordes del control PasswordRecovery. |
| BorderStyle |
Obtiene o establece el estilo del borde del control de servidor web. (Heredado de WebControl) |
| BorderWidth |
Obtiene o establece el ancho del borde del control de servidor web. (Heredado de WebControl) |
| ChildControlsCreated |
Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Heredado de Control) |
| ClientID |
Obtiene el id. de control para marcado HTML que se genera por ASP.NET. (Heredado de Control) |
| ClientIDMode |
Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Heredado de Control) |
| ClientIDSeparator |
Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Heredado de Control) |
| Context |
Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Heredado de Control) |
| Controls |
Obtiene un objeto ControlCollection que representa los controles secundarios de CompositeControl. (Heredado de CompositeControl) |
| ControlStyle |
Obtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Heredado de WebControl) |
| ControlStyleCreated |
Obtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles. (Heredado de WebControl) |
| CssClass |
Obtiene o establece la clase hoja de estilos en cascada (CSS) presentada por el control de servidor web en el cliente. (Heredado de WebControl) |
| DataItemContainer |
Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Heredado de Control) |
| DataKeysContainer |
Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Heredado de Control) |
| DesignMode |
Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Heredado de Control) |
| Enabled |
Obtiene o establece un valor que indica si el control de servidor web está habilitado. (Heredado de WebControl) |
| EnableTheming |
Obtiene o establece un valor que indica si los temas se aplican a este control. (Heredado de WebControl) |
| EnableViewState |
Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control) |
| Events |
Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Heredado de Control) |
| FailureTextStyle |
Obtiene una referencia a una colección de propiedades que definen la apariencia del texto de error del control PasswordRecovery. |
| Font |
Obtiene las propiedades de fuente asociadas al control de servidor web. (Heredado de WebControl) |
| ForeColor |
Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Heredado de WebControl) |
| GeneralFailureText |
Obtiene o establece el mensaje de error que se muestra cuando hay un problema con el proveedor de pertenencia del control PasswordRecovery. |
| HasAttributes |
Obtiene un valor que indica si el control tiene establecido algún atributo. (Heredado de WebControl) |
| HasChildViewState |
Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Heredado de Control) |
| Height |
Obtiene o establece el alto del control de servidor Web. (Heredado de WebControl) |
| HelpPageIconUrl |
Obtiene o establece la dirección URL de una imagen que se muestra al lado del vínculo a la página de Ayuda. |
| HelpPageText |
Obtiene o establece el texto del vínculo a la página de Ayuda de recuperación de la contraseña. |
| HelpPageUrl |
Obtiene o establece la dirección URL de la página de Ayuda de recuperación de la contraseña. |
| HyperLinkStyle |
Obtiene una referencia a una colección de propiedades que definen la apariencia de los hipervínculos del control PasswordRecovery. |
| ID |
Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control) |
| IdSeparator |
Obtiene el carácter utilizado para separar los identificadores de control. (Heredado de Control) |
| InstructionTextStyle |
Obtiene una referencia a una colección de propiedades de estilo que definen la apariencia del texto de explicación del control PasswordRecovery. |
| IsChildControlStateCleared |
Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Heredado de Control) |
| IsEnabled |
Obtiene un valor que indica si está habilitado el control. (Heredado de WebControl) |
| IsTrackingViewState |
Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Heredado de Control) |
| IsViewStateEnabled |
Obtiene un valor que indica si el estado de vista está habilitado para este control. (Heredado de Control) |
| LabelStyle |
Obtiene una referencia a una colección de propiedades de estilo que definen la apariencia de las etiquetas del cuadro de texto del control PasswordRecovery. |
| LoadViewStateByID |
Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Heredado de Control) |
| MailDefinition |
Obtiene una referencia a una colección de propiedades que definen las características de los mensajes de correo electrónico usados para enviar contraseñas nuevas o recuperadas a los usuarios. |
| MembershipProvider |
Obtiene o establece el proveedor de pertenencia empleado para buscar información del usuario. |
| NamingContainer |
Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID. (Heredado de Control) |
| Page |
Obtiene una referencia a la instancia Page que contiene el control de servidor. (Heredado de Control) |
| Parent |
Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Heredado de Control) |
| Question |
Obtiene la pregunta de confirmación de recuperación de la contraseña establecida por el usuario en el sitio Web. |
| QuestionFailureText |
Obtiene o establece el texto que se muestra cuando la respuesta del usuario a la pregunta de confirmación de recuperación de la contraseña no coincide con la respuesta almacenada en el almacén de datos del sitio Web. |
| QuestionInstructionText |
Obtiene o establece el texto que se muestra en la vista de pregunta para indicar al usuario que conteste a la pregunta de confirmación de recuperación de la contraseña. |
| QuestionLabelText |
Obtiene o establece el texto de la etiqueta del cuadro de texto Question. |
| QuestionTemplate |
Obtiene o establece la plantilla que se utiliza para mostrar la vista de pregunta del control PasswordRecovery. |
| QuestionTemplateContainer |
Obtiene el contenedor que un control PasswordRecovery usa para crear una instancia de la plantilla QuestionTemplate. Esta propiedad proporciona acceso mediante programación a los controles secundarios. |
| QuestionTitleText |
Obtiene o establece el título para la vista de pregunta del control PasswordRecovery. |
| RenderingCompatibility |
Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Heredado de Control) |
| RenderOuterTable |
Obtiene o establece un valor que indica si el control encierra el HTML presentado en un elemento |
| Site |
Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Heredado de Control) |
| SkinID |
Obtiene o establece la máscara que se aplica al control. (Heredado de WebControl) |
| Style |
Obtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web. (Heredado de WebControl) |
| SubmitButtonImageUrl |
Obtiene o establece la dirección URL de una imagen que se utiliza como botón Enviar. |
| SubmitButtonStyle |
Obtiene una referencia a una colección de propiedades que definen la apariencia de los botones de envío del control PasswordRecovery. |
| SubmitButtonText |
Obtiene o establece el texto del botón que envía el formulario. |
| SubmitButtonType |
Obtiene o establece el tipo de botón de envío que se utiliza al representar el control PasswordRecovery. |
| SuccessPageUrl |
Obtiene o establece la dirección URL de la página que se va a mostrar después de enviar correctamente una contraseña. |
| SuccessTemplate |
Obtiene o establece la plantilla utilizada para mostrar la vista de proceso correcto del control PasswordRecovery. |
| SuccessTemplateContainer |
Obtiene el contenedor que un control PasswordRecovery usa para crear una instancia de la plantilla SuccessTemplate. Esta propiedad proporciona acceso mediante programación a los controles secundarios. |
| SuccessText |
Obtiene o establece el texto que se muestra después de enviar correctamente una contraseña. |
| SuccessTextStyle |
Obtiene una referencia a una colección de propiedades de estilo que definen la apariencia del texto que se muestra en la vista de proceso correcto del control PasswordRecovery. |
| SupportsDisabledAttribute |
Obtiene un valor que indica si el control debe establecer en "disabled" el atributo |
| TabIndex |
Obtiene o establece el índice de tabulación del control de servidor web. (Heredado de WebControl) |
| TagKey |
Obtiene el valor de HtmlTextWriterTag correspondiente a un control PasswordRecovery. |
| TagName |
Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles. (Heredado de WebControl) |
| TemplateControl |
Obtiene o establece una referencia a la plantilla que contiene este control. (Heredado de Control) |
| TemplateSourceDirectory |
Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Heredado de Control) |
| TextBoxStyle |
Obtiene una referencia a una colección de propiedades de estilo que definen la apariencia de los cuadros de texto del control PasswordRecovery. |
| TextLayout |
Obtiene o establece un valor que especifica si se muestra el control PasswordRecovery en un diseño horizontal o vertical. |
| TitleTextStyle |
Obtiene una referencia a una colección de propiedades de estilo que definen la apariencia del texto del título que aparece en el controlPasswordRecovery. |
| ToolTip |
Obtiene o establece el texto que se muestra cuando el puntero del mouse se desplaza sobre el control de servidor web. (Heredado de WebControl) |
| UniqueID |
Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Heredado de Control) |
| UserName |
Obtiene o establece el texto que aparece en el cuadro de texto Nombre de usuario. |
| UserNameFailureText |
Obtiene o establece el texto que se muestra cuando el nombre de usuario escrito por el usuario no es un nombre válido para el sitio Web. |
| UserNameInstructionText |
Obtiene o establece el texto que se muestra en la vista de nombre de usuario del control PasswordRecovery para indicar al usuario que escriba un nombre de usuario. |
| UserNameLabelText |
Obtiene o establece el texto de la etiqueta del cuadro de texto Nombre de usuario. |
| UserNameRequiredErrorMessage |
Obtiene o establece el mensaje de error que se muestra cuando el usuario deja vacío el cuadro de texto Nombre de usuario. |
| UserNameTemplate |
Obtiene o establece la plantilla que se utiliza para mostrar la vista de nombre de usuario del control PasswordRecovery. |
| UserNameTemplateContainer |
Obtiene el contenedor que un control PasswordRecovery usa para crear una instancia de la plantilla UserNameTemplate. Esta propiedad proporciona acceso mediante programación a los controles secundarios. |
| UserNameTitleText |
Obtiene o establece el título para la vista de nombre del usuario del control PasswordRecovery. |
| ValidateRequestMode |
Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos. (Heredado de Control) |
| ValidatorTextStyle |
Obtiene una referencia a una colección de propiedades Style que definen la apariencia de los mensajes de error asociados a la validación de los datos de entrada que el control PasswordRecovery utiliza. |
| ViewState |
Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página. (Heredado de Control) |
| ViewStateIgnoresCase |
Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Heredado de Control) |
| ViewStateMode |
Obtiene o establece el modo del estado de vista de este control. (Heredado de Control) |
| Visible |
Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página. (Heredado de Control) |
| Width |
Obtiene o establece el ancho del control de servidor web. (Heredado de WebControl) |
Métodos
| AddAttributesToRender(HtmlTextWriter) |
Agrega atributos y estilos HTML que se deben representar en el HtmlTextWriterTag especificado. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl) |
| AddedControl(Control, Int32) |
Se llama después de agregar un control secundario a la colección Controls del objeto Control. (Heredado de Control) |
| AddParsedSubObject(Object) |
Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor. (Heredado de Control) |
| ApplyStyle(Style) |
Copia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo. Este método lo usan principalmente los programadores de controles. (Heredado de WebControl) |
| ApplyStyleSheetSkin(Page) |
Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Heredado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Comienza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control) |
| BuildProfileTree(String, Boolean) |
Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página. (Heredado de Control) |
| ClearCachedClientID() |
Establece en |
| ClearChildControlState() |
Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Heredado de Control) |
| ClearChildState() |
Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Heredado de Control) |
| ClearChildViewState() |
Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control) |
| ClearEffectiveClientIDMode() |
Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Heredado de Control) |
| CopyBaseAttributes(WebControl) |
Copia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl) |
| CreateChildControls() |
Crea los controles individuales que componen el control PasswordRecovery. |
| CreateControlCollection() |
Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor. (Heredado de Control) |
| CreateControlStyle() |
Crea el objeto de estilo que utiliza la clase WebControl de forma interna para implementar todas las propiedades relacionadas con el estilo. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl) |
| DataBind() |
Enlaza un origen de datos a CompositeControl y todos sus controles secundarios. (Heredado de CompositeControl) |
| DataBind(Boolean) |
Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Heredado de Control) |
| DataBindChildren() |
Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control) |
| Dispose() |
Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Heredado de Control) |
| EndRenderTracing(TextWriter, Object) |
Finaliza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control) |
| EnsureChildControls() |
Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Heredado de Control) |
| EnsureID() |
Crea un identificador para controles que no tiene un identificador asignado. (Heredado de Control) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| FindControl(String) |
Busca un control de servidor con el parámetro |
| FindControl(String, Int32) |
Busca el contenedor de nomenclatura actual para un control de servidor con el |
| Focus() |
Establece el foco de entrada en un control. (Heredado de Control) |
| GetDesignModeState() |
Obtiene datos en tiempo de diseño para un control. (Heredado de Control) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetRouteUrl(Object) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control) |
| GetRouteUrl(String, Object) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| GetUniqueIDRelativeTo(Control) |
Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Heredado de Control) |
| HasControls() |
Determina si el control de servidor contiene controles secundarios. (Heredado de Control) |
| HasEvents() |
Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Heredado de Control) |
| IsLiteralContent() |
Determina si el control de servidor alberga únicamente contenido literal. (Heredado de Control) |
| LoadControlState(Object) |
Implementa el método LoadControlState(Object) base. |
| LoadViewState(Object) |
Implementa el método LoadViewState(Object) base. |
| MapPathSecure(String) |
Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Heredado de Control) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| MergeStyle(Style) |
Copia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl) |
| OnAnswerLookupError(EventArgs) |
Genera el evento AnswerLookupError. |
| OnBubbleEvent(Object, EventArgs) |
Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página. |
| OnDataBinding(EventArgs) |
Genera el evento DataBinding. (Heredado de Control) |
| OnInit(EventArgs) |
Implementa el método OnInit(EventArgs) base. |
| OnLoad(EventArgs) |
Genera el evento Load. (Heredado de Control) |
| OnPreRender(EventArgs) |
Implementa el método OnPreRender(EventArgs) base. |
| OnSendingMail(MailMessageEventArgs) |
Genera el evento SendingMail. |
| OnSendMailError(SendMailErrorEventArgs) |
Genera el evento SendMailError cuando un mensaje de correo electrónico no se puede enviar al usuario. |
| OnUnload(EventArgs) |
Genera el evento Unload. (Heredado de Control) |
| OnUserLookupError(EventArgs) |
Genera el evento UserLookupError. |
| OnVerifyingAnswer(LoginCancelEventArgs) |
Genera el evento VerifyingAnswer. |
| OnVerifyingUser(LoginCancelEventArgs) |
Genera el evento VerifyingUser. |
| OpenFile(String) |
Obtiene un objeto Stream utilizado para leer un archivo. (Heredado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Asigna los orígenes del evento y su información al control principal del control. (Heredado de Control) |
| RecreateChildControls() |
Vuelve a crear los controles secundarios de un control derivado de CompositeControl. (Heredado de CompositeControl) |
| RemovedControl(Control) |
Se llama después de quitar un control secundario de la colección Controls del objeto Control. (Heredado de Control) |
| Render(HtmlTextWriter) |
Escribe el contenido del elemento CompositeControl en el objeto HtmlTextWriter especificado para su representación en el cliente. |
| RenderBeginTag(HtmlTextWriter) |
Representa la etiqueta HTML de apertura del control en el sistema de escritura especificado. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl) |
| RenderChildren(HtmlTextWriter) |
Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente. (Heredado de Control) |
| RenderContents(HtmlTextWriter) |
Representa el contenido del control en el sistema de escritura especificado. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl) |
| RenderControl(HtmlTextWriter) |
Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento. (Heredado de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Heredado de Control) |
| RenderEndTag(HtmlTextWriter) |
Presenta la etiqueta HTML de cierre del control en el escritor especificado. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl) |
| ResolveAdapter() |
Obtiene el adaptador de controles que se encarga de representar el control especificado. (Heredado de Control) |
| ResolveClientUrl(String) |
Obtiene una dirección URL que el explorador puede utilizar. (Heredado de Control) |
| ResolveUrl(String) |
Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Heredado de Control) |
| SaveControlState() |
Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor. |
| SaveViewState() |
Guarda cualquier estado modificado después de invocar el método TrackViewState(). |
| SetDesignModeState(IDictionary) |
Implementa el método IControlDesignerAccessor.SetDesignModeState(IDictionary) base. |
| SetRenderMethodDelegate(RenderMethod) |
Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Heredado de Control) |
| SetTraceData(Object, Object) |
Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento. (Heredado de Control) |
| SetTraceData(Object, Object, Object) |
Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento. (Heredado de Control) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| TrackViewState() |
Implementa el método TrackViewState() base. |
Eventos
| AnswerLookupError |
Aparece cuando el usuario proporciona una respuesta incorrecta a la pregunta de confirmación de recuperación de la contraseña. |
| DataBinding |
Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control) |
| Disposed |
Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET. (Heredado de Control) |
| Init |
Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Heredado de Control) |
| Load |
Se produce cuando el control de servidor se carga en el objeto Page. (Heredado de Control) |
| PreRender |
Se produce una vez que se carga el objeto Control, pero antes de su representación. (Heredado de Control) |
| SendingMail |
Se produce antes de que se envíe al usuario una contraseña por correo electrónico. |
| SendMailError |
Se produce cuando el sistema de correo SMTP genera un error al intentar enviar un mensaje de correo electrónico. |
| Unload |
Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control) |
| UserLookupError |
Aparece cuando el proveedor de pertenencia no encuentra el nombre de usuario proporcionado por el usuario. |
| VerifyingAnswer |
Aparece cuando el usuario ha enviado una respuesta a la pregunta de confirmación de recuperación de la contraseña. |
| VerifyingUser |
Aparece antes de que el proveedor de pertenencia valide el nombre de usuario. |
Implementaciones de interfaz explícitas
| IAttributeAccessor.GetAttribute(String) |
Obtiene un atributo del control Web con el nombre especificado. (Heredado de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Establece un atributo del control Web con el nombre y el valor especificados. (Heredado de WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Permite que un diseñador vuelva a crear la colección de controles secundarios del control compuesto en el entorno en tiempo de diseño. (Heredado de CompositeControl) |
| IControlBuilderAccessor.ControlBuilder |
Para obtener una descripción de este miembro, vea ControlBuilder. (Heredado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obtener una descripción de este miembro, vea GetDesignModeState(). (Heredado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary). (Heredado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obtener una descripción de este miembro, vea SetOwnerControl(Control). (Heredado de Control) |
| IControlDesignerAccessor.UserData |
Para obtener una descripción de este miembro, vea UserData. (Heredado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obtener una descripción de este miembro, vea DataBindings. (Heredado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obtener una descripción de este miembro, vea HasDataBindings. (Heredado de Control) |
| IExpressionsAccessor.Expressions |
Para obtener una descripción de este miembro, vea Expressions. (Heredado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obtener una descripción de este miembro, vea HasExpressions. (Heredado de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Para obtener una descripción de este miembro, vea AddParsedSubObject(Object). (Heredado de Control) |
Métodos de extensión
| FindDataSourceControl(Control) |
Devuelve el origen de datos que está asociado al control de datos del control especificado. |
| FindFieldTemplate(Control, String) |
Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. |
| FindMetaTable(Control) |
Devuelve el objeto de metatabla para el control de datos contenedor. |
| GetDefaultValues(INamingContainer) |
Obtiene la colección de los valores predeterminados para el control de datos especificado. |
| GetMetaTable(INamingContainer) |
Obtiene los metadatos de la tabla para el control de datos especificado. |
| SetMetaTable(INamingContainer, MetaTable) |
Establece los metadatos de la tabla para el control de datos especificado. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina si están disponibles los metadatos de la tabla. |
| EnableDynamicData(INamingContainer, Type) |
Habilita el comportamiento de datos dinámicos para el control de datos especificado. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Habilita el comportamiento de datos dinámicos para el control de datos especificado. |
| EnableDynamicData(INamingContainer, Type, Object) |
Habilita el comportamiento de datos dinámicos para el control de datos especificado. |
Se aplica a
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de