Personalizar la apariencia de los controles ASP.NET de inicio de sesión

Actualización: noviembre 2007

Puede personalizar el contenido de varios controles de inicio de sesión de ASP.NET especificando las plantillas de los controles y agregando sus propios controles a la interfaz de usuario (UI) del control, o reemplazando o eliminando controles opcionales que no sean necesarios para la interfaz de usuario del control.

También puede utilizar las propiedades de estilo de los controles de inicio de sesión así como los temas y máscaras para personalizar el aspecto del control. Para obtener más información, consulte los miembros del control específico y Información general sobre temas y máscaras de ASP.NET.

Controles de inicio de sesión personalizables

Puede personalizar el contenido de cualquier control de inicio de sesión donde la interfaz de usuario del control existente se puede reemplazar utilizando una plantilla. Esto incluye los controles Login, PasswordRecovery, CreateUserWizard y ChangePassword. La tabla siguiente muestra las plantillas que están disponibles para personalizar con cada control.

  • Login
    Utilice la plantilla LayoutTemplate para especificar diferentes controles para recuperar un nombre de usuario y una contraseña para iniciar una sesión.

  • PasswordRecovery
    Utilice la plantilla UserNameTemplate para especificar diferentes controles para recuperar el nombre de usuario para el que recuperar la contraseña.

    Utilice la plantilla QuestionTemplate para especificar diferentes controles para recuperar la pregunta de la contraseña si la propiedad RequiresQuestionAndAnswer es true.

    Utilice la plantilla SuccessTemplate para especificar controles diferentes que aparecen cuando se ha recuperado la contraseña de un usuario correctamente.

  • CreateUserWizard
    Utilice la plantilla ContentTemplate del paso CreateUserStep para especificar diferentes controles para recuperar el nombre de usuario, contraseña y otra información necesaria para crear una nueva cuenta de usuario.

    Utilice la plantilla ContentTemplate del paso CompleteStep para especificar controles diferentes que aparecen cuando la operación de crear usuario ha finalizado.

  • ChangePassword
    Utilice la plantilla ChangePasswordTemplate para especificar diferentes controles para recuperar el nombre de usuario, la contraseña actual y la contraseña nueva para el usuario que está cambiando su contraseña.

    Utilice la plantilla SuccessTemplate para especificar controles diferentes que aparecen cuando se ha cambiado la contraseña de un usuario correctamente.

Especificar los controles en las plantillas de controles de inicio de sesión

Puede incluir controles y botones de comando adicionales en las plantillas de controles de inicio de sesión así como reemplazar los controles predeterminados y los botones de comando con los suyos propios.

Reemplazar los botones de comando en una plantilla de controles de inicio de sesión

Puede utilizar cualquier control como botón de comando en una plantilla de controles de inicio de sesión. Sin embargo, para que el control de inicio de sesión reconozca el comando, el control del comando debe propagar un evento que incluya argumentos de eventos que hereden de la clase CommandEventArgs. El botón de comando debe especificar un valor para la propiedad CommandName de la clase CommandEventArgs que identifica el comando que va a ejecutar el control de inicio de sesión. La tabla siguiente muestra los valores válidos para la propiedad CommandName y sus plantillas de control de inicio de sesión relacionadas.

Reemplazar los controles en una plantilla de controles de inicio de sesión

Puede reemplazar los controles de entrada y presentación que utilizan varios controles de inicio de sesión de ASP.NET en sus plantillas respectivas. Cada plantilla tiene controles que deben ser incluidos en la plantilla así como controles opcionales. Los controles necesarios y opcionales se identifican utilizando la propiedad ID del control. Si una plantilla no incluye un control donde la propiedad ID esté establecida en un identificador de control necesario o si dicho control no implementa la interfaz apropiada, el control de inicio de sesión de ASP.NET producirá una excepción.

La siguiente tabla enumera las plantillas y los controles necesarios según sus propiedades ID.

  • Login.LayoutTemplate
    UserName - El nombre de cuenta del usuario que va a iniciar una sesión. Este control es necesario y debe implementar la interfaz IEditableTextControl.

    Password - La contraseña del usuario que va a iniciar una sesión. Este control es necesario y debe implementar la interfaz IEditableTextControl.

    RememberMe - true para almacenar el símbolo (token) de autenticación en una cookie persistente; false para almacenar el símbolo (token) de autenticación en una cookie de la sesión. Este control es opcional y debe implementar la interfaz ICheckBoxControl.

    FailureText - Muestra un mensaje de error de inicio de sesión. Este control es opcional y debe implementar la interfaz ITextControl.

  • PasswordRecovery.UserNameTemplate
    UserName - El nombre de cuenta del usuario para recuperar su contraseña. Este control es necesario y debe implementar la interfaz IEditableTextControl.

    FailureText - Muestra un mensaje de error de recuperación de contraseña. Este control es opcional y debe implementar la interfaz ITextControl.

  • PasswordRecovery.QuestionTemplate
    UserName - Muestra el nombre de cuenta del usuario para el que se recupera la contraseña. Este control es opcional y debe implementar la interfaz ITextControl.

    Question - La pregunta de la contraseña del usuario para el que se recupera la contraseña. Este control es opcional y debe implementar la interfaz ITextControl.

    Answer - La respuesta de la contraseña del usuario para el que se recupera la contraseña. Este control es necesario y debe implementar la interfaz IEditableTextControl.

    FailureText - Muestra un mensaje de error de recuperación de contraseña. Este control es opcional y debe implementar la interfaz ITextControl.

  • CreateUserWizard.CreateUserStep
    UserName - El nombre de cuenta de la cuenta de usuario que se va a crear. Este control es necesario y debe implementar la interfaz IEditableTextControl.

    Password - La contraseña de la cuenta de usuario que se va a crear. Este control es necesario y debe implementar la interfaz IEditableTextControl.

    ConfirmPassword - Un valor de confirmación que debe coincidir con la contraseña. Este control es opcional y debe implementar la interfaz IEditableTextControl.

    Question - La pregunta de la contraseña del usuario que se va a crear. Este control es necesario si la propiedad RequiresQuestionAndAnswer es true y debe implementar la interfaz IEditableTextControl.

    Answer - La respuesta de la contraseña del usuario que se va a crear. Este control es necesario si la propiedad RequiresQuestionAndAnswer es true y debe implementar la interfaz IEditableTextControl.

    Email - La dirección de correo electrónico para la cuenta de usuario que se va a crear. Este control es necesario si la propiedad RequiresUniqueEmail es true y debe implementar la interfaz IEditableTextControl.

    ErrorMessage - Muestra un mensaje de error de creación de cuenta de usuario. Este control es opcional y debe implementar la interfaz ITextControl.

  • ChangePassword.ChangePasswordTemplate
    UserName - El nombre de cuenta de la cuenta de usuario que se va a crear. Este control es necesario si la propiedad DisplayUserName es true y debe implementar la interfaz IEditableTextControl.

    CurrentPassword - La contraseña actual para la cuenta de usuario. Este control es necesario y debe implementar la interfaz IEditableTextControl.

    NewPassword - La nueva contraseña para la cuenta de usuario. Este control es necesario y debe implementar la interfaz IEditableTextControl.

    ConfirmPassword - Un valor de confirmación que debe coincidir con la contraseña nueva. Este control es opcional y debe implementar la interfaz IEditableTextControl.

    FailureText - Muestra un mensaje de error de creación de cuenta de usuario. Este control es opcional y debe implementar la interfaz ITextControl.

Hacer referencia a un control en una plantilla de controles de inicio de sesión

Para hacer referencia a un control en una plantilla de controles de inicio de sesión, puede llamar al método FindControl del contenedor para la plantilla de controles. La tabla siguiente muestra las plantillas y sus propiedades de contenedor asociadas.

Por ejemplo, si tuviera que incluir un control DropDownList con un identificador de TimeZoneList en la plantilla ContentTemplate del paso CreateUserStep de un control CreateUserWizard, puede hacer referencia al control DropDownList llamando al método FindControl del contenedor ContentTemplateContainer de la propiedad CreateUserStep, como se muestra en el siguiente ejemplo.

Protected Sub CreateUserWizard1_CreatedUser(sender As Object, e As EventArgs)
  Dim timeZoneList As DropDownList = _
    CType(CreateUserWizard1.CreateUserStep.ContentTemplateContainer.FindControl("TimeZoneList"), DropDownList)
End Sub

protected void CreateUserWizard1_CreatedUser(object sender, EventArgs e)
{
  DropDownList timeZoneList = 
    (DropDownList)CreateUserWizard1.CreateUserStep.ContentTemplateContainer.FindControl("TimeZoneList");
}

Vea también

Conceptos

Configurar una aplicación ASP.NET para utilizar la suscripción

Referencia

Información general sobre controles de inicio de sesión de ASP.NET

  • Last updated on