Login Clase

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

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í.

Proporciona elementos de interfaz de usuario (UI) para iniciar sesión en un sitio web.

public ref class Login : System::Web::UI::WebControls::CompositeControl

[System.ComponentModel.Bindable(false)]
public class Login : System.Web.UI.WebControls.CompositeControl

[<System.ComponentModel.Bindable(false)>]
type Login = class
    inherit CompositeControl

Public Class Login
Inherits CompositeControl

Herencia: Object

Control

WebControl

CompositeControl
Login

Atributos: BindableAttribute

Ejemplos

En el ejemplo de código siguiente se usa un Login control para proporcionar una interfaz de usuario para iniciar sesión en un sitio web.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.ComponentModel" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
bool IsValidEmail(string strIn)
{
    // Return true if strIn is in valid email format.
    return Regex.IsMatch(strIn, @"^([\w\-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$"); 
}

void OnLoggingIn(object sender, System.Web.UI.WebControls.LoginCancelEventArgs e)
{
    if (!IsValidEmail(Login1.UserName))
    {
        Login1.InstructionText = "Enter a valid email address.";
        Login1.InstructionTextStyle.ForeColor = System.Drawing.Color.RosyBrown;
        e.Cancel = true;
    }
    else
    {
        Login1.InstructionText = String.Empty;
    }
}

void OnLoginError(object sender, EventArgs e)
{
    Login1.HelpPageText = "Help with logging in...";
    Login1.PasswordRecoveryText = "Forgot your password?";
}
</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:Login id="Login1" runat="server" 
                BorderStyle="Solid" 
                BackColor="#F7F7DE" 
                BorderWidth="1px"
                BorderColor="#CCCC99" 
                Font-Size="10pt" 
                Font-Names="Verdana" 
                CreateUserText="Create a new user..."
                CreateUserUrl="newUser.aspx" 
                HelpPageUrl="help.aspx"
                PasswordRecoveryUrl="getPass.aspx" 
                UserNameLabelText="Email address:" 
                OnLoggingIn="OnLoggingIn"
                OnLoginError="OnLoginError" >
                <TitleTextStyle Font-Bold="True" 
                    ForeColor="#FFFFFF" 
                    BackColor="#6B696B">
                </TitleTextStyle>
            </asp:Login>

        </form>
    </body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.ComponentModel" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
Function IsValidEmail(ByVal strIn As String) As Boolean
    ' Return true if strIn is in valid email format.
    Return Regex.IsMatch(strIn, ("^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$"))
End Function

Sub OnLoggingIn(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LoginCancelEventArgs)
    If Not IsValidEmail(Login1.UserName) Then
        Login1.InstructionText = "Enter a valid email address."
        Login1.InstructionTextStyle.ForeColor = System.Drawing.Color.RosyBrown
        e.Cancel = True
    Else
        Login1.InstructionText = String.Empty
    End If
End Sub

Sub OnLoginError(ByVal sender As Object, ByVal e As EventArgs)
    Login1.HelpPageText = "Help with logging in..."
    Login1.PasswordRecoveryText = "Forgot your password?"
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:Login id="Login1" runat="server" 
                BorderStyle="Solid" 
                BackColor="#F7F7DE" 
                BorderWidth="1px"
                BorderColor="#CCCC99" 
                Font-Size="10pt" 
                Font-Names="Verdana" 
                CreateUserText="Create a new user..."
                CreateUserUrl="newUser.aspx" 
                HelpPageUrl="help.aspx"
                PasswordRecoveryUrl="getPass.aspx" 
                UserNameLabelText="Email address:" 
                OnLoggingIn="OnLoggingIn"
                OnLoginError="OnLoginError" >
                <TitleTextStyle Font-Bold="True" 
                    ForeColor="#FFFFFF" 
                    BackColor="#6B696B">
                </TitleTextStyle>
            </asp:Login>

        </form>
    </body>
</html>

En el ejemplo de código siguiente se muestra cómo puede extender el Login control. El CustomLogin control incluye un DropDownList control que permite a los usuarios elegir con qué proveedor de pertenencia se autentican. (Estos proveedores se configuran en Web.config). En el OnLoggingIn método , la MembershipProvider propiedad se establece en el valor seleccionado del DropDownList control.

Importante

Este ejemplo contiene un cuadro de texto que acepta la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET páginas web validan que la entrada del usuario no incluye elementos HTML ni de script. Para obtener más información, consulte Información general sobre vulnerabilidades de seguridad de script.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.Controls
{
    public sealed class CustomLogin : Login
    {
        public CustomLogin() { }
        
        protected override void OnLoggingIn(LoginCancelEventArgs e)
        {
            // Set the Membership provider for the Login control from a DropDownList.
            DropDownList list = (DropDownList)this.FindControl("domain");
            this.MembershipProvider = list.SelectedValue;
            base.OnLoggingIn(e);
        }
        
        protected override void CreateChildControls()
        {
            LayoutTemplate = new MyTemplate();
            base.CreateChildControls();
        }
    }
    
    // A Template that contains the child controls.
    public class MyTemplate : ITemplate
    {
        void ITemplate.InstantiateIn(Control container)
        {
            // A TextBox for the user name.
            TextBox username = new TextBox();
            username.ID = "username";
            
            // A TextBox for the password.
            TextBox password = new TextBox();
            password.ID = "password";
            
            // A CheckBox to remember the user on subsequent visits.
            CheckBox remember = new CheckBox();
            remember.ID = "RememberMe";
            remember.Text = "Don't forget me!";
            
            // Failure Text.
            Literal failure = new Literal();
            failure.ID = "FailureText";
            
            // A DropDownList to choose the Membership provider.
            DropDownList domain = new DropDownList();
            domain.ID = "Domain";
            domain.Items.Add(new ListItem("SqlMembers"));
            domain.Items.Add(new ListItem("SqlMembers2"));
            
            // A Button to log in.
            Button submit = new Button();
            submit.CommandName = "login";
            submit.Text = "LOGIN";

            container.Controls.Add(new LiteralControl("UserName:"));
            container.Controls.Add(username);
            container.Controls.Add(new LiteralControl("<br>Password:"));
            container.Controls.Add(password);
            container.Controls.Add(new LiteralControl("<br>"));
            container.Controls.Add(remember);
            container.Controls.Add(new LiteralControl("<br>Domain:"));
            container.Controls.Add(domain);
            container.Controls.Add(new LiteralControl("<br>"));
            container.Controls.Add(failure);
            container.Controls.Add(new LiteralControl("<br>"));
            container.Controls.Add(submit);
        }
    }    
}

Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

Namespace Samples.AspNet.Controls

    NotInheritable Public Class CustomLogin
        Inherits Login

        Public Sub New() 
        End Sub

        Protected Overrides Sub OnLoggingIn(ByVal e As LoginCancelEventArgs) 

            ' Set the Membership provider for the Login control from a DropDownList.
            Dim list As DropDownList = CType(Me.FindControl("domain"), DropDownList)
            Me.MembershipProvider = list.SelectedValue
            MyBase.OnLoggingIn(e)

        End Sub


        Protected Overrides Sub CreateChildControls() 

            LayoutTemplate = New MyTemplate()
            MyBase.CreateChildControls()

        End Sub
    End Class

    ' A Template that contains the child controls.
    Public Class MyTemplate
        Implements ITemplate

        Sub InstantiateIn(ByVal container As Control)  Implements ITemplate.InstantiateIn
            ' A TextBox for the user name.
            Dim username As New TextBox()
            username.ID = "username"

            ' A TextBox for the password.
            Dim password As New TextBox()
            password.ID = "password"

            ' A CheckBox to remember the user on subsequent visits.
            Dim remember As New CheckBox()
            remember.ID = "RememberMe"
            remember.Text = "Don't forget me!"

            ' Failure Text.
            Dim failure As New Literal()
            failure.ID = "FailureText"

            ' A DropDownList to choose the Membership provider.
            Dim domain As New DropDownList()
            domain.ID = "Domain"
            domain.Items.Add(New ListItem("SqlMembers"))
            domain.Items.Add(New ListItem("SqlMembers2"))

            ' A Button to log in.
            Dim submit As New Button()
            submit.CommandName = "login"
            submit.Text = "LOGIN"

            container.Controls.Add(New LiteralControl("UserName:"))
            container.Controls.Add(username)
            container.Controls.Add(New LiteralControl("<br>Password:"))
            container.Controls.Add(password)
            container.Controls.Add(New LiteralControl("<br>"))
            container.Controls.Add(remember)
            container.Controls.Add(New LiteralControl("<br>Domain:"))
            container.Controls.Add(domain)
            container.Controls.Add(New LiteralControl("<br>"))
            container.Controls.Add(failure)
            container.Controls.Add(New LiteralControl("<br>"))
            container.Controls.Add(submit)

        End Sub
    End Class
End Namespace

Comentarios

En este tema:

Introduction
Estilo y plantillas
Agrupaciones de validación
Accesibilidad
Aplicación de estilos CSS
Sintaxis declarativa

Introducción

El Login control es un control compuesto que proporciona todos los elementos comunes de la interfaz de usuario necesarios para autenticar a un usuario en un sitio web. Los tres elementos siguientes son necesarios para todos los escenarios de inicio de sesión:

Un nombre de usuario único para identificar al usuario.
Contraseña para comprobar la identidad del usuario.
Un botón de inicio de sesión para enviar la información de inicio de sesión al servidor.

El Login control también proporciona los siguientes elementos opcionales de interfaz de usuario que admiten funciones adicionales:

Vínculo para un recordatorio de contraseña.
Una casilla Recordarme para conservar la información de inicio de sesión entre sesiones.
Un vínculo de Ayuda para los usuarios que tienen problemas para iniciar sesión.
Vínculo Registrar nuevo usuario que redirige a los usuarios a una página de registro.
Texto de instrucción que aparece en el formulario de inicio de sesión.
Texto de error personalizado que aparece cuando el usuario hace clic en el botón de inicio de sesión sin rellenar los campos de nombre de usuario o contraseña.
Texto de error personalizado que aparece si se produce un error en el inicio de sesión.
Una acción personalizada que tiene lugar cuando el inicio de sesión se realiza correctamente.
Una manera de ocultar el control de inicio de sesión si el usuario ya ha iniciado sesión en el sitio.

Para obtener una tabla que muestre qué controles son necesarios y cuáles son opcionales, consulte la LayoutTemplate propiedad .

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.

Importante

Aceptar la entrada del usuario es una posible amenaza de seguridad. 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 básicas de seguridad para aplicaciones web y Protección de la pertenencia.

El Login control usa un proveedor de pertenencia para obtener credenciales de usuario. A menos que especifique lo contrario, el Login control usa el proveedor de pertenencia predeterminado definido en el archivo Web.config. Para especificar un proveedor diferente, establezca la MembershipProvider propiedad en uno de los nombres de proveedor de pertenencia definidos en el archivo Web.config de la aplicación. Para obtener más información, consulte Proveedores de pertenencia.

Si desea usar un servicio de autenticación personalizado, puede usar el OnAuthenticate método para llamar al servicio.

Estilos y plantillas

La apariencia del Login control es totalmente personalizable a través de plantillas y configuraciones de estilo. Todos los mensajes de texto de la interfaz de usuario también se pueden personalizar mediante propiedades de la Login clase . El texto de la interfaz predeterminada se localiza automáticamente en función de la configuración regional del servidor.

Si el Login 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.

Login Las propiedades de control representadas por cuadros de texto, como UserName y Password, 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.

Nota:

Si inserta el Login control en un WizardStep objeto, establezca explícitamente la ActiveStepIndex propiedad en un Page_Load controlador de eventos si el usuario está autenticado. El Wizard control no avanza automáticamente al siguiente WizardStep objeto en este escenario.

En la tabla siguiente se enumeran las propiedades de Login estilo de control y se explica qué elemento de interfaz de usuario afecta 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
BorderPadding	Espacio entre el contenido del control y el borde del control.
CheckBoxStyle	Casilla Recordarme.
FailureTextStyle	Texto de error de inicio de sesión.
InstructionTextStyle	Texto informativo de 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.
ValidatorTextStyle	Texto que se muestra al usuario cuando un intento de inicio de sesión no se realiza correctamente debido a errores de validación.
HyperLinkStyle	Vínculos a otras páginas.
LoginButtonStyle	Botón de inicio de sesión.

Agrupaciones de validación

Las UserName propiedades y Password tienen RequiredFieldValidator controles asociados a ellos para impedir que los usuarios envíen la página sin proporcionar información necesaria.

El Login control usa un grupo de validación para que otros campos de la misma página que el Login control se puedan validar por separado. De forma predeterminada, la ID propiedad del Login control se usa como nombre del grupo de validación. Por ejemplo, un Login control con el identificador "Login1" usará un nombre de grupo de validación de "Login1". Si desea establecer el grupo de validación del que forma parte el Login control, debe crear una plantilla para el control y cambiar el nombre del grupo de validación.

Aplicación de estilos CSS

El Login control le permite especificar reglas de estilo CSS en el marcado. Si usa plantillas para personalizar la apariencia del Login 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 falseen .

Accesibilidad

Para obtener información sobre cómo configurar este control para que genere marcado que se ajuste a los estándares de accesibilidad, consulte Accesibilidad en Visual Studio y ASP.NET y ASP.NET Controles y accesibilidad.

Sintaxis declarativa

<asp:Login
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderPadding="integer"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CreateUserIconUrl="uri"
    CreateUserText="string"
    CreateUserUrl="uri"
    CssClass="string"
    DestinationPageUrl="uri"
    DisplayRememberMe="True|False"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FailureAction="Refresh|RedirectToLoginPage"
    FailureText="string"
    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"
    Height="size"
    HelpPageIconUrl="uri"
    HelpPageText="string"
    HelpPageUrl="uri"
    ID="string"
    InstructionText="string"
    LoginButtonImageUrl="uri"
    LoginButtonText="string"
    LoginButtonType="Button|Image|Link"
    MembershipProvider="string"
    OnAuthenticate="Authenticate event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnLoggedIn="LoggedIn event handler"
    OnLoggingIn="LoggingIn event handler"
    OnLoginError="LoginError event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    Orientation="Horizontal|Vertical"
    PasswordLabelText="string"
    PasswordRecoveryIconUrl="uri"
    PasswordRecoveryText="string"
    PasswordRecoveryUrl="uri"
    PasswordRequiredErrorMessage="string"
    RememberMeSet="True|False"
    RememberMeText="string"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    TextLayout="TextOnLeft|TextOnTop"
    TitleText="string"
    ToolTip="string"
    UserName="string"
    UserNameLabelText="string"
    UserNameRequiredErrorMessage="string"
    Visible="True|False"
    VisibleWhenLoggedIn="True|False"
    Width="size"
>
        <CheckBoxStyle />
        <FailureTextStyle />
        <HyperLinkStyle />
        <InstructionTextStyle />
        <LabelStyle />
        <LayoutTemplate>
            <!-- child controls -->
        </LayoutTemplate>
        <LoginButtonStyle />
        <TextBoxStyle />
        <TitleTextStyle />
        <ValidatorTextStyle />
</asp:Login>

Constructores

Nombre	Description
Login()	Crea una nueva instancia del Login control .

Campos

Nombre	Description
LoginButtonCommandName	Representa el nombre del comando asociado al botón de inicio de sesión.

Propiedades

Nombre	Description
AccessKey	Obtiene o establece la clave de acceso que le 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)
AppRelativeTemplateSourceDirectory	Obtiene o establece el directorio virtual relativo a la Page aplicación del objeto o UserControl que contiene este control. (Heredado de Control)
Attributes	Obtiene la colección de atributos arbitrarios (solo para la representación) que no corresponden a las 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 Login control.
BorderStyle	Obtiene o establece el estilo de borde del control de servidor web. (Heredado de WebControl)
BorderWidth	Obtiene o establece el ancho de borde del control de servidor web. (Heredado de WebControl)
CheckBoxStyle	Obtiene una referencia a un Style objeto que define la configuración de la casilla Recordarme.
ChildControlsCreated	Obtiene un valor que indica si se han creado los controles secundarios del control de servidor. (Heredado de Control)
ClientID	Obtiene el identificador de control para el marcado HTML generado por ASP.NET. (Heredado de Control)
ClientIDMode	Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad . (Heredado de Control)
ClientIDSeparator	Obtiene un valor de carácter que representa el carácter separador utilizado en la ClientID propiedad . (Heredado de Control)
Context	Obtiene el HttpContext objeto asociado al control de servidor para la solicitud web actual. (Heredado de Control)
Controls	Obtiene un ControlCollection objeto que representa los controles secundarios de un CompositeControlobjeto . (Heredado de CompositeControl)
ControlStyle	Obtiene el estilo del control de servidor web. Esta propiedad se usa principalmente por los desarrolladores de control. (Heredado de WebControl)
ControlStyleCreated	Obtiene un valor que indica si se ha creado un Style objeto para la ControlStyle propiedad . Esta propiedad la usan principalmente los desarrolladores de controles. (Heredado de WebControl)
CreateUserIconUrl	Obtiene la ubicación de una imagen que se va a mostrar junto al vínculo a una página de registro para los nuevos usuarios.
CreateUserText	Obtiene o establece el texto de un vínculo a una página de registro para los nuevos usuarios.
CreateUserUrl	Obtiene o establece la dirección URL de la página de registro de nuevo usuario.
CssClass	Obtiene o establece la clase Hoja de estilos en cascada (CSS) representada por el control de servidor web en el cliente. (Heredado de WebControl)
DataItemContainer	Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataItemContainer. (Heredado de Control)
DataKeysContainer	Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataKeysControl. (Heredado de Control)
DesignMode	Obtiene un valor que indica si se usa un control en una superficie de diseño. (Heredado de Control)
DestinationPageUrl	Obtiene o establece la dirección URL de la página que se muestra al usuario cuando un intento de inicio de sesión se realiza correctamente.
DisplayRememberMe	Obtiene o establece un valor que indica si se va a mostrar una casilla para permitir al usuario controlar si se envía una cookie persistente a su explorador.
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 y el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control)
Events	Obtiene una lista de delegados del controlador de eventos para el control . Esta propiedad es de solo lectura. (Heredado de Control)
FailureAction	Obtiene o establece la acción que se produce cuando se produce un error en un intento de inicio de sesión.
FailureText	Obtiene o establece el texto que se muestra cuando se produce un error en un intento de inicio de sesión.
FailureTextStyle	Obtiene una referencia a una colección de propiedades que definen la apariencia del texto de error en el Login control.
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)
HasAttributes	Obtiene un valor que indica si el control tiene los atributos establecidos. (Heredado de WebControl)
HasChildViewState	Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardada. (Heredado de Control)
Height	Obtiene o establece el alto del control de servidor web. (Heredado de WebControl)
HelpPageIconUrl	Obtiene la ubicación de una imagen que se va a mostrar junto al vínculo a la página de ayuda de inicio de sesión.
HelpPageText	Obtiene o establece el texto de un vínculo a la página de ayuda de inicio de sesión.
HelpPageUrl	Obtiene o establece la dirección URL de la página de ayuda de inicio de sesión.
HyperLinkStyle	Obtiene una referencia a una colección de propiedades que definen la apariencia de los hipervínculos en el Login control .
ID	Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control)
IdSeparator	Obtiene el carácter usado para separar los identificadores de control. (Heredado de Control)
InstructionText	Obtiene o establece el texto de instrucción de inicio de sesión del usuario.
InstructionTextStyle	Obtiene una referencia a un TableItemStyle objeto que define la configuración del texto de instrucción en el Login control .
IsChildControlStateCleared	Obtiene un valor que indica si los controles contenidos en este control tienen estado de control. (Heredado de Control)
IsEnabled	Obtiene un valor que indica si el control está habilitado. (Heredado de WebControl)
IsTrackingViewState	Obtiene un valor que indica si el control de servidor guarda los cambios 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 un TableItemStyle objeto que define la configuración de Login las etiquetas de control.
LayoutTemplate	Obtiene o establece la plantilla utilizada para mostrar el Login control.
LoadViewStateByID	Obtiene un valor que indica si el control participa en la carga de su estado de vista en ID lugar del índice. (Heredado de Control)
LoginButtonImageUrl	Obtiene o establece la dirección URL de una imagen que se va a usar para el botón de inicio de sesión.
LoginButtonStyle	Obtiene una referencia al Style objeto que permite establecer la apariencia del botón de inicio de sesión en el Login control.
LoginButtonText	Obtiene o establece el texto Login del botón de inicio de sesión del control.
LoginButtonType	Obtiene o establece el tipo de botón que se va a usar al representar el Login botón.
MembershipProvider	Obtiene o establece el nombre del proveedor de datos de pertenencia utilizado por el control .
NamingContainer	Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar entre los controles de servidor con el mismo ID valor de propiedad. (Heredado de Control)
Orientation	Obtiene o establece un valor que especifica la posición de los elementos del Login control en la página.
Page	Obtiene una referencia a la Page instancia que contiene el control de servidor. (Heredado de Control)
Parent	Obtiene una referencia al control primario del control de servidor en la jerarquía de controles de página. (Heredado de Control)
Password	Obtiene la contraseña especificada por el usuario.
PasswordLabelText	Obtiene o establece el texto de la etiqueta del cuadro de Password texto.
PasswordRecoveryIconUrl	Obtiene la ubicación de una imagen que se va a mostrar junto al vínculo a la página de recuperación de contraseñas.
PasswordRecoveryText	Obtiene o establece el texto de un vínculo a la página de recuperación de contraseñas.
PasswordRecoveryUrl	Obtiene o establece la dirección URL de la página de recuperación de contraseñas.
PasswordRequiredErrorMessage	Obtiene o establece el mensaje de error que se va a mostrar en un ValidationSummary control cuando el campo de contraseña se deja en blanco.
RememberMeSet	Obtiene o establece un valor que indica si se va a enviar una cookie de autenticación persistente al explorador del usuario.
RememberMeText	Obtiene o establece el texto de la etiqueta de la casilla Recordarme.
RenderingCompatibility	Obtiene un valor que especifica la versión de ASP.NET con la que se representará HTML. (Heredado de Control)
RenderOuterTable	Obtiene o establece un valor que indica si el control incluye html representado en un `table` elemento para aplicar estilos insertados.
Site	Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño. (Heredado de Control)
SkinID	Obtiene o establece la máscara que se va a aplicar al control. (Heredado de WebControl)
Style	Obtiene una colección de atributos de texto que se representarán como un atributo de estilo en la etiqueta externa del control de servidor web. (Heredado de WebControl)
SupportsDisabledAttribute	Obtiene un valor que indica si el control debe establecer el `disabled` atributo del elemento HTML representado en "disabled" cuando la propiedad del IsEnabled control es `false`. (Heredado de CompositeControl)
TabIndex	Obtiene o establece el índice de tabulación del control de servidor web. (Heredado de WebControl)
TagKey	Obtiene el HtmlTextWriterTag valor que corresponde a un Login control . Esta propiedad se usa principalmente por los desarrolladores de control.
TagName	Obtiene el nombre de la etiqueta de control. Esta propiedad se usa principalmente por los desarrolladores de control. (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 que definen la apariencia de los cuadros de texto en el Login control .
TextLayout	Especifica la posición de cada etiqueta en relación con su cuadro de texto asociado para el Login control.
TitleText	Obtiene o establece el título del Login control.
TitleTextStyle	Obtiene una referencia a una colección de propiedades que definen la apariencia del texto del título en el Login control.
ToolTip	Obtiene o establece el texto que se muestra cuando el puntero del mouse mantiene el puntero 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 el nombre de usuario especificado por el usuario.
UserNameLabelText	Obtiene o establece el texto de la etiqueta del cuadro de UserName texto.
UserNameRequiredErrorMessage	Obtiene o establece el mensaje de error que se va a mostrar en un ValidationSummary control cuando el campo nombre de usuario se deja en blanco.
ValidateRequestMode	Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para detectar valores potencialmente peligrosos. (Heredado de Control)
ValidatorTextStyle	Obtiene una referencia a una colección de Style propiedades que definen la apariencia de los mensajes de error asociados a los validadores usados por el Login control.
ViewState	Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor en varias solicitudes para la misma página. (Heredado de Control)
ViewStateIgnoresCase	Obtiene un valor que indica si el StateBag objeto no distingue mayúsculas de minúsculas. (Heredado de Control)
ViewStateMode	Obtiene o establece el modo de 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)
VisibleWhenLoggedIn	Obtiene o establece un valor que indica si se va a mostrar el Login control una vez autenticado el usuario.
Width	Obtiene o establece el ancho del control de servidor web. (Heredado de WebControl)

Métodos

Nombre	Description
AddAttributesToRender(HtmlTextWriter)	Agrega atributos y estilos HTML que deben representarse en el especificado HtmlTextWriterTag. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
AddedControl(Control, Int32)	Se llama después de agregar un control secundario a la Controls colección del Control objeto . (Heredado de Control)
AddParsedSubObject(Object)	Notifica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega el elemento al objeto del control de ControlCollection servidor. (Heredado de Control)
ApplyStyle(Style)	Copia todos los elementos que no sean de marca del estilo especificado en el control Web, sobrescribir los elementos de estilo existentes del control. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica las propiedades de estilo definidas en la hoja de estilos de página al control . (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 entrega a la Trace propiedad que se va a mostrar cuando el seguimiento está habilitado para la página. (Heredado de Control)
ClearCachedClientID()	Establece el valor `null`almacenado en caché en ClientID . (Heredado de Control)
ClearChildControlState()	Elimina la información de estado de control de los controles secundarios del control de servidor. (Heredado de Control)
ClearChildState()	Elimina la información de estado de vista y estado de control de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearChildViewState()	Elimina la información de estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearEffectiveClientIDMode()	Establece la ClientIDMode propiedad de la instancia de control actual y de cualquier control secundario en Inherit. (Heredado de Control)
CopyBaseAttributes(WebControl)	Copia las propiedades no encapsuladas por el Style objeto desde el control de servidor web especificado al control de servidor web desde el que se llama a este método. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
CreateChildControls()	Crea los controles individuales que componen el Login control y asocia controladores de eventos a sus eventos.
CreateControlCollection()	Crea un nuevo ControlCollection objeto para contener los controles secundarios (literal y servidor) del control de servidor. (Heredado de Control)
CreateControlStyle()	Crea el objeto de estilo que usa internamente la WebControl clase para implementar todas las propiedades relacionadas con el estilo. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
DataBind()	Enlaza un origen de datos a CompositeControl y a todos sus controles secundarios. (Heredado de CompositeControl)
DataBind(Boolean)	Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios con una opción para generar el DataBinding evento. (Heredado de Control)
DataBindChildren()	Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control)
Dispose()	Permite que un control de servidor realice la limpieza final antes de liberarse 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 es así, crea controles secundarios. (Heredado de Control)
EnsureID()	Crea un identificador para los controles que no tienen asignado un identificador. (Heredado de Control)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
FindControl(String, Int32)	Busca en el contenedor de nomenclatura actual un control de servidor con el especificado `id` y un entero, especificado en el `pathOffset` parámetro , que ayuda en la búsqueda. No debe invalidar esta versión del FindControl método. (Heredado de Control)
FindControl(String)	Busca en el contenedor de nomenclatura actual un control de servidor con el parámetro especificado `id` . (Heredado de Control)
Focus()	Establece el foco de entrada en un control. (Heredado de Control)
GetDesignModeState()	Obtiene los datos en tiempo de diseño de un control. (Heredado de Control)
GetHashCode()	Actúa como 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 prefijo de la UniqueID propiedad 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 los eventos están registrados para el control o para los controles secundarios. (Heredado de Control)
IsLiteralContent()	Determina si el control de servidor contiene solo contenido literal. (Heredado de Control)
LoadControlState(Object)	Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState() método . (Heredado de Control)
LoadViewState(Object)	Restaura la información de estado de vista de una solicitud anterior que se guardó con el SaveViewState() método .
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 Objectactual. (Heredado de Object)
MergeStyle(Style)	Copia todos los elementos que no sean de marca del estilo especificado en el control Web, pero no sobrescribirán ningún elemento de estilo existente del control. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
OnAuthenticate(AuthenticateEventArgs)	Genera el Authenticate evento para autenticar al usuario.
OnBubbleEvent(Object, EventArgs)	Determina si se debe pasar un evento 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)	Genera el evento Init. (Heredado de Control)
OnLoad(EventArgs)	Genera el evento Load. (Heredado de Control)
OnLoggedIn(EventArgs)	Genera el LoggedIn evento después de que el usuario inicie sesión en el sitio web y se haya autenticado.
OnLoggingIn(LoginCancelEventArgs)	Genera el LoggingIn evento cuando un usuario envía información de inicio de sesión, pero antes de que se produzca la autenticación.
OnLoginError(EventArgs)	Genera el LoginError evento cuando se produce un error en un intento de inicio de sesión.
OnPreRender(EventArgs)	Implementa el método base OnPreRender(EventArgs) .
OnUnload(EventArgs)	Genera el evento Unload. (Heredado de Control)
OpenFile(String)	Obtiene un objeto Stream que se usa para leer un archivo. (Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)	Asigna cualquier origen del evento y su información al elemento primario 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 Controls colección del Control objeto . (Heredado de Control)
Render(HtmlTextWriter)	Representa el formulario de inicio de sesión con el escritor HTML especificado.
RenderBeginTag(HtmlTextWriter)	Representa la etiqueta de apertura HTML del control en el escritor especificado. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
RenderChildren(HtmlTextWriter)	Genera el contenido de los elementos secundarios de un control de servidor en un objeto proporcionado HtmlTextWriter , que escribe el contenido que se va a representar en el cliente. (Heredado de Control)
RenderContents(HtmlTextWriter)	Representa el contenido del control en el escritor especificado. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter mediante un objeto proporcionado ControlAdapter . (Heredado de Control)
RenderControl(HtmlTextWriter)	Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter y almacena información de seguimiento sobre el control si el seguimiento está habilitado. (Heredado de Control)
RenderEndTag(HtmlTextWriter)	Representa la etiqueta de cierre HTML del control en el escritor especificado. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
ResolveAdapter()	Obtiene el adaptador de control responsable de representar el control especificado. (Heredado de Control)
ResolveClientUrl(String)	Obtiene una dirección URL que el explorador puede usar. (Heredado de Control)
ResolveUrl(String)	Convierte una dirección URL en una que se pueda usar en el cliente solicitante. (Heredado de Control)
SaveControlState()	Guarda los cambios de estado de control de servidor que se han producido desde el momento en que se devolvió la página al servidor. (Heredado de Control)
SaveViewState()	Guarda cualquier estado que se modificó después de invocar el TrackViewState() método .
SetDesignModeState(IDictionary)	Establece los datos en tiempo de diseño de un control.
SetRenderMethodDelegate(RenderMethod)	Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en su control primario. (Heredado de Control)
SetTraceData(Object, Object, Object)	Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante el objeto rastreado, la clave de datos de seguimiento y el valor de los datos de seguimiento. (Heredado de Control)
SetTraceData(Object, Object)	Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante la clave de datos de seguimiento y el valor de los datos de seguimiento. (Heredado de Control)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TrackViewState()	Invalida el método base TrackViewState() .

Eventos

Nombre	Description
Authenticate	Se produce cuando se autentica un usuario.
DataBinding	Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control)
Disposed	Se produce cuando se libera un control de servidor de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página de ASP.NET. (Heredado de Control)
Init	Se produce cuando se inicializa el control de servidor, que es el primer paso de su ciclo de vida. (Heredado de Control)
Load	Se produce cuando el control de servidor se carga en el Page objeto . (Heredado de Control)
LoggedIn	Se produce cuando el usuario inicia sesión en el sitio web y se ha autenticado.
LoggingIn	Se produce cuando un usuario envía información de inicio de sesión, antes de que se produzca la autenticación.
LoginError	Se produce cuando se detecta un error de inicio de sesión.
PreRender	Se produce después de cargar el Control objeto, pero antes de la representación. (Heredado de Control)
Unload	Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control)

Implementaciones de interfaz explícitas

Nombre	Description
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 en el nombre y el valor especificados. (Heredado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite a un diseñador volver 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

Nombre	Description
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.
EnableDynamicData(INamingContainer, Type)	Habilita el comportamiento de datos dinámicos para el control de datos especificado.
FindDataSourceControl(Control)	Devuelve el origen de datos asociado al control de datos para el control especificado.
FindFieldTemplate(Control, String)	Devuelve la plantilla de campo de la columna especificada en el contenedor de nomenclatura del control especificado.
FindMetaTable(Control)	Devuelve el objeto de metatable 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, IDictionary<String,Object>)	Establece los metadatos de la tabla y la asignación de valores predeterminados para el control de datos especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Establece los metadatos de la tabla y la asignación de valores predeterminados para el control de datos especificado.
SetMetaTable(INamingContainer, MetaTable)	Establece los metadatos de la tabla para el control de datos especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina si los metadatos de la tabla están disponibles.

Se aplica a

Consulte también

Comentarios

¿Le resultó útil esta página?

Compartir vía

Login Clase

Definición

Ejemplos

Comentarios

Introducción

Estilos y plantillas

Agrupaciones de validación

Aplicación de estilos CSS

Accesibilidad

Sintaxis declarativa

Constructores

Campos

Propiedades

Métodos

Eventos

Implementaciones de interfaz explícitas

Métodos de extensión

Se aplica a

Consulte también

Comentarios