LoginView LoginView LoginView LoginView Class

Definición

Muestra la plantilla de contenido adecuada para un usuario determinado, basándose en el estado de autenticación y la pertenencia a roles del usuario.Displays the appropriate content template for a given user, based on the user's authentication status and role membership.

public ref class LoginView : System::Web::UI::Control, System::Web::UI::INamingContainer
[System.ComponentModel.Bindable(false)]
[System.Web.UI.Themeable(true)]
public class LoginView : System.Web.UI.Control, System.Web.UI.INamingContainer
type LoginView = class
    inherit Control
    interface INamingContainer
Public Class LoginView
Inherits Control
Implements INamingContainer
Herencia
LoginViewLoginViewLoginViewLoginView
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer plantillas para cada uno de los tres tipos de LoginView plantillas admitidos por el control.The following code example shows how to set templates for each of the three template types supported by the LoginView 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">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <p>
                <asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus></p>
            <p>
                <asp:LoginView id="LoginView1" runat="server">
                    <AnonymousTemplate>
                        Please log in for personalized information.
                    </AnonymousTemplate>
                    <LoggedInTemplate>
                        Thanks for logging in 
                        <asp:LoginName id="LoginName1" runat="Server"></asp:LoginName>.
                    </LoggedInTemplate>
                    <RoleGroups>
                        <asp:RoleGroup Roles="Admin">
                            <ContentTemplate>
                                <asp:LoginName id="LoginName2" runat="Server"></asp:LoginName>, you
                                are logged in as an administrator.
                            </ContentTemplate>
                        </asp:RoleGroup>
                    </RoleGroups>
                </asp:LoginView></p>
        </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">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <p>
                <asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus></p>
            <p>
                <asp:LoginView id="LoginView1" runat="server">
                    <AnonymousTemplate>
                        Please log in for personalized information.
                    </AnonymousTemplate>
                    <LoggedInTemplate>
                        Thanks for logging in 
                        <asp:LoginName id="LoginName1" runat="Server"></asp:LoginName>.
                    </LoggedInTemplate>
                    <RoleGroups>
                        <asp:RoleGroup Roles="Admin">
                            <ContentTemplate>
                                <asp:LoginName id="LoginName2" runat="Server"></asp:LoginName>, you
                                are logged in as an administrator.
                            </ContentTemplate>
                        </asp:RoleGroup>
                    </RoleGroups>
                </asp:LoginView></p>
        </form>
    </body>
</html>

Comentarios

En este tema:In this topic:

IntroducciónIntroduction

El LoginView control muestra diferentes plantillas de contenido de sitio web (o "vistas") para distintos usuarios, en función de si el usuario está autenticado y, en caso afirmativo, a qué roles de sitio web pertenece.The LoginView control displays different Web site content templates (or "views") for different users, based on whether the user is authenticated and, if so, which Web site roles he or she belongs to.

Nota

Si no está familiarizado con el conjunto de controles de inicio de sesión disponibles en ASP.NET, consulte información general sobre los controles de inicio de sesión de ASP.net antes de continuar.If you are not familiar with the set of login controls available in ASP.NET, see ASP.NET Login Controls Overview before continuing. Para obtener una lista de otros temas relacionados con los controles de inicio de sesión y la pertenencia, consulte Administración de usuariosmediante pertenencia.For a list of other topics related to login controls and membership, see Managing Users by Using Membership.

La plantilla almacenada en AnonymousTemplate la propiedad se muestra a cualquier visitante del sitio web que no ha iniciado sesión.The template stored in the AnonymousTemplate property is displayed to any visitor to the Web site who has not logged in. Una vez que un usuario ha iniciado sesión, el sitio muestra una plantilla asociada a uno de los roles del usuario en RoleGroups la propiedad o la plantilla predeterminada especificada en LoggedInTemplate la propiedad.Once a user is logged in, the site displays either a template associated with one of the user's roles in the RoleGroups property or the default template specified in the LoggedInTemplate property.

El LoginView control administra el cambio entre las distintas plantillas una vez que se asignan plantillas a cualquiera de las tres LoginView propiedades de plantilla de la clase:The LoginView control manages switching among the various templates once you assign templates to any of the three template properties of the LoginView class:

  • AnonymousTemplate: Especifica la plantilla que se va a mostrar a los usuarios que no han iniciado sesión en el sitio Web.AnonymousTemplate - Specifies the template to display to users who are not logged in to the Web site. Los usuarios que iniciaron sesión nunca verán esta plantilla.Users who are logged in will never see this template.

  • LoggedInTemplate-Especifica la plantilla predeterminada que se va a mostrar a los usuarios que han iniciado sesión en el sitio web, pero que no pertenecen a ningún grupo de roles con plantillas definidas.LoggedInTemplate - Specifies the default template to display to users who are logged in to the Web site but do not belong to any role groups with defined templates.

  • RoleGroups-Especifica la plantilla que se va a mostrar a los usuarios con sesión iniciada que son miembros de roles con plantillas de grupo de roles definidas.RoleGroups - Specifies the template to display to logged-in users who are members of roles with defined role-group templates. Las plantillas de contenido se asocian con determinados conjuntos RoleGroup de roles en las instancias de.Content templates are associated with particular sets of roles in RoleGroup instances.

Las plantillas de grupo de roles se buscan en el orden en el que se definen en el origen.Role-group templates are searched in the order they are defined in the source. La primera plantilla de grupo de roles coincidente se muestra al usuario.The first matching role-group template is displayed to the user. Si un usuario es miembro de más de un rol, se usa la primera plantilla de grupo de roles que coincida con cualquiera de los roles del usuario.If a user is a member of more than one role, the first role-group template that matches any of the user's roles is used. Si hay más de una plantilla asociada a un único rol, solo se usa la primera plantilla definida.If more than one template is associated with a single role, only the first defined template is used.

En la tabla siguiente se describe el comportamiento LoginView del control cuando se usan varias combinaciones de plantillas.The following table describes the behavior of the LoginView control when various combinations of templates are used.

Propiedad de la plantilla de registroLoggedIn Template Property Propiedad de plantilla anónimaAnonymous Template Property Propiedad RoleGroupsRoleGroups Property Comportamiento de LoginViewLoginView behavior
Sin establecerNot set Sin establecerNot set Sin establecerNot set No muestra ningún contenido.Displays no content.
SetSet Sin establecerNot set Sin establecerNot set Muestra el contenido solo cuando el usuario ha iniciado sesión.Displays content only when the user is logged in.
Sin establecerNot set SetSet Sin establecerNot set Muestra el contenido solo cuando el usuario no ha iniciado sesión.Displays content only when the user is not logged in.
Sin establecerNot set Sin establecerNot set SetSet Muestra la primera plantilla de la RoleGroups colección que coincide con uno de los roles del usuario.Displays the first template in the RoleGroups collection that matches one of the user's roles. Si no se encuentra ninguna coincidencia, no muestra ningún contenido.If no match is found, displays no content.
SetSet SetSet Sin establecerNot set Si el usuario ha iniciado sesión, muestra la plantilla especificada en la LoggedInTemplate propiedad.If the user is logged in, displays the template specified in the LoggedInTemplate property. Si el usuario no ha iniciado sesión, muestra la plantilla especificada en la AnonymousTemplate propiedad.If the user in not logged in, displays the template specified in the AnonymousTemplate property.
SetSet SetSet SetSet Si el usuario ha iniciado sesión, muestra la primera plantilla de la RoleGroups colección que coincide con uno de los roles del usuario.If the user is logged in, displays the first template in the RoleGroups collection that matches one of the user's roles. Si no se encuentra ninguna coincidencia, muestra la plantilla especificada en LoggedInTemplate la propiedad.If no match is found, displays the template specified in the LoggedInTemplate property. Si el usuario no ha iniciado sesión, muestra la plantilla especificada en la AnonymousTemplate propiedad.If the user is not logged in, displays the template specified in the AnonymousTemplate property.
SetSet Sin establecerNot set SetSet Si el usuario ha iniciado sesión, muestra la primera plantilla de la RoleGroups colección que coincide con uno de los roles del usuario.If the user is logged in, displays the first template in the RoleGroups collection that matches one of the user's roles. Si no se encuentra ninguna coincidencia, muestra la plantilla especificada en LoggedInTemplate la propiedad.If no match is found, displays the template specified in the LoggedInTemplate property. Si el usuario no ha iniciado sesión, no se muestra nada.If the user is not logged in, nothing is displayed.
Sin establecerNot set SetSet SetSet Si el usuario ha iniciado sesión, muestra la primera plantilla de la RoleGroups colección que coincide con uno de los roles del usuario.If the user is logged in, displays the first template in the RoleGroups collection that matches one of the user's roles. Si no se encuentra ninguna coincidencia, no se muestra nada.If no match is found, nothing is displayed. Si el usuario no ha iniciado sesión, muestra la plantilla especificada en la AnonymousTemplate propiedad.If the user is not logged in, displays the template specified in the AnonymousTemplate property.

User Page Name Y se pueden usar con cualquier esquema de autenticación que establezca la propiedad de la propiedad del objeto. LoggedInTemplate AnonymousTemplateThe AnonymousTemplate and LoggedInTemplate can be used with any authentication scheme that sets the Name property of the Page object's User property. Debe configurar la administración de roles para utilizar RoleGroups la propiedad a fin de definir las plantillas en función del rol del usuario en el sitio Web.You must configure role management to use the RoleGroups property to define templates base on the user's role on the Web site. Para obtener más información, vea Descripción de la Administración de roles.For more information, see Understanding Role Management.

El Focus método no establece el foco inicial de la página web en el LoginView control ni en ninguno de sus controles secundarios.The Focus method does not set the initial focus of the Web page to the LoginView control, or any of its child controls. Los controles contenidos en LoginView el control se crean después PreRender del evento.Controls contained in the LoginView control are created after the PreRender event. Para establecer el foco en un control secundario que contiene LoginView, On_PreRender controle y llame a su Focus método.To set the focus to a child control contained by the LoginView, handle the On_PreRender and call its Focus method. También puede utilizar los ViewChanging eventos y ViewChanged para tener acceso mediante programación a los controles de las LoginView plantillas de control.You can also use the ViewChanging and ViewChanged events to programmatically access the controls in the LoginView control templates.

Sintaxis declarativaDeclarative Syntax

<asp:LoginView  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    ID="string"  
    OnDataBinding="DataBinding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnUnload="Unload event handler"  
    OnViewChanged="ViewChanged event handler"  
    OnViewChanging="ViewChanging event handler"  
    runat="server"  
    SkinID="string"  
    Visible="True|False"  
>  
        <AnonymousTemplate>  
            <!-- child controls -->  
        </AnonymousTemplate>  
        <LoggedInTemplate>  
            <!-- child controls -->  
        </LoggedInTemplate>  
        <RoleGroups>  
                <asp:RoleGroup  
                    Roles="string"  
                >  
                        <ContentTemplate>  
                            <!-- child controls -->  
                        </ContentTemplate>  
                </asp:RoleGroup>  
        </RoleGroups>  
</asp:LoginView>  

Constructores

LoginView() LoginView() LoginView() LoginView()

Inicializa una nueva instancia del control LoginView.Initializes a new instance of the LoginView control.

Propiedades

Adapter Adapter Adapter Adapter

Obtiene el adaptador específico del explorador para el control.Gets the browser-specific adapter for the control.

(Inherited from Control)
AnonymousTemplate AnonymousTemplate AnonymousTemplate AnonymousTemplate

Obtiene o establece la plantilla que se ha de mostrar a los usuarios que no hayan iniciado una sesión en el sitio Web.Gets or sets the template to display to users who are not logged in to the Web site.

AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
BindingContainer BindingContainer BindingContainer BindingContainer

Obtiene el control que contiene el enlace de datos de este control.Gets the control that contains this control's data binding.

(Inherited from Control)
ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
Context Context Context Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls Controls

Obtiene el objeto ControlCollection que contiene los controles secundarios del control LoginView.Gets the ControlCollection object that contains the child controls for the LoginView control.

DataItemContainer DataItemContainer DataItemContainer DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
EnableTheming EnableTheming EnableTheming EnableTheming

Obtiene o establece un valor que indica si se pueden aplicar temas al control LoginView.Gets or sets a value indicating whether themes can be applied to the LoginView control.

EnableViewState EnableViewState EnableViewState 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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
Events Events Events Events

Obtiene una lista de delegados de controladores de eventos del control.Gets a list of event handler delegates for the control. Esta propiedad es de sólo lectura.This property is read-only.

(Inherited from Control)
HasChildViewState HasChildViewState HasChildViewState HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.For a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

Para una descripción de este miembro, vea UserData.For a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

Obtiene o establece el identificador de programación asignado al control de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

Para una descripción de este miembro, vea DataBindings.For a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

Para obtener una descripción de este miembro, vea HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.Gets the character used to separate control identifiers.

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

Para una descripción de este miembro, vea Expressions.For a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

Para una descripción de este miembro, vea HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from Control)
LoggedInTemplate LoggedInTemplate LoggedInTemplate LoggedInTemplate

Obtiene o establece la plantilla que se ha de mostrar a usuarios del sitio Web que, pese a haber iniciado una sesión en él, no sean miembros de uno de los grupos de roles especificados en la propiedad RoleGroups.Gets or sets the template to display to Web site users who are logged in to the Web site but are not members of one of the role groups specified in the RoleGroups property.

NamingContainer NamingContainer NamingContainer 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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
Page Page Page Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent Parent Parent Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
RoleGroups RoleGroups RoleGroups RoleGroups

Obtiene una colección de grupos de roles que asocian plantillas de contenido a determinados roles.Gets a collection of role groups that associate content templates with particular roles.

Site Site Site Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

Obtiene o establece la máscara que se ha de aplicar al control LoginView.Gets or sets the skin to apply to the LoginView control.

TemplateControl TemplateControl TemplateControl TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
UniqueID UniqueID UniqueID UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
ViewState ViewState ViewState 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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

Obtiene o establece el modo del estado de vista de este control.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible Visible Visible Visible

Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Inherited from Control)

Métodos

AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) 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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from Control)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.Applies the style properties defined in the page style sheet to the control.

(Inherited from Control)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) 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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
CreateChildControls() CreateChildControls() CreateChildControls() CreateChildControls()

Crea los controles secundarios que constituyen el control LoginView.Creates the child controls that make up the LoginView control.

CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Inherited from Control)
DataBind() DataBind() DataBind() DataBind()

Enlaza un origen de datos a LoginView y a todos sus controles secundarios.Binds a data source to LoginView and all its child controls.

DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) 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.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.Binds a data source to the server control's child controls.

(Inherited from Control)
Dispose() Dispose() Dispose() Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() EnsureChildControls()

Determina si el control de servidor contiene controles secundarios.Determines whether the server control contains child controls. Si no tiene controles secundarios, los crea.If it does not, it creates child controls.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.Searches the current naming container for a server control with the specified id parameter.

(Inherited from Control)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

(Inherited from Control)
Focus() Focus() Focus() Focus()

Establece el foco de entrada en un control.Sets input focus to a control.

GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.Gets design-time data for a control.

(Inherited from Control)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
HasControls() HasControls() HasControls() HasControls()

Determina si el control de servidor contiene controles secundarios.Determines if the server control contains any child controls.

(Inherited from Control)
HasEvents() HasEvents() HasEvents() HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
IsLiteralContent() IsLiteralContent() IsLiteralContent() IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) LoadControlState(Object)

Este método implementa LoadControlState(Object).This method implements LoadControlState(Object).

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Restaura la información sobre el estado de vista de una solicitud de página anterior guardada por el método SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

(Inherited from Control)
MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) 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.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Inherited from Control)
OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Genera el evento DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs)

Genera el evento Init.Raises the Init event.

OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Genera el evento Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Determina qué plantilla de grupo de roles se va a mostrar, a partir de los roles del usuario conectado.Determines which role-group template to display, based on the roles of the logged-in user.

OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Genera el evento Unload.Raises the Unload event.

(Inherited from Control)
OnViewChanged(EventArgs) OnViewChanged(EventArgs) OnViewChanged(EventArgs) OnViewChanged(EventArgs)

Provoca el evento ViewChanged después de que el control LoginView cambie las vistas.Raises the ViewChanged event after the LoginView control switches views.

OnViewChanging(EventArgs) OnViewChanging(EventArgs) OnViewChanging(EventArgs) OnViewChanging(EventArgs)

Provoca el evento ViewChanging antes de que el control LoginView cambie las vistas.Raises the ViewChanging event before the LoginView control switches views.

OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.Gets a Stream used to read a file.

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter)

Representa el contenido del control de servidor Web en el explorador del cliente por medio del objeto HtmlTextWriter especificado.Renders the Web server control content to the client's browser using the specified HtmlTextWriter object.

RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter)

Envía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) 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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from Control)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() 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.Saves any server control state changes that have occurred since the time the page was posted back to the server.

SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Guarda los cambios realizados en el estado de vista del control de servidor desde que la página volvió a publicarse en el servidor.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

(Inherited from Control)
SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.Sets design-time data for a control.

SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) 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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) 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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Origina el seguimiento de los cambios del estado de vista del control de servidor de manera que se puedan almacenar en el objeto StateBag del control de servidor.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Este objeto es accesible a través de la propiedad ViewState.This object is accessible through the ViewState property.

(Inherited from Control)

Eventos

DataBinding DataBinding DataBinding DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.Occurs when the server control binds to a data source.

(Inherited from Control)
Disposed Disposed Disposed 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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Init Init Init Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load Load Load Load

Se produce cuando el control de servidor se carga en el objeto Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PreRender PreRender PreRender PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
Unload Unload Unload Unload

Se produce cuando el control de servidor se descarga de la memoria.Occurs when the server control is unloaded from memory.

(Inherited from Control)
ViewChanged ViewChanged ViewChanged ViewChanged

Se produce tras cambiar la vista.Occurs after the view is changed.

ViewChanging ViewChanging ViewChanging ViewChanging

Se produce antes de cambiar la vista.Occurs before the view is changed.

Implementaciones de interfaz explícitas

IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea GetDesignModeState().For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

Para una descripción de este miembro, vea SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

Para una descripción de este miembro, vea AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)

Métodos de extensión

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer) GetDefaultValues(INamingContainer)

Obtiene la colección de los valores predeterminados para el control de datos especificado.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer) GetMetaTable(INamingContainer)

Obtiene los metadatos de la tabla para el control de datos especificado.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable) SetMetaTable(INamingContainer, MetaTable)

Establece los metadatos de la tabla para el control de datos especificado.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object) SetMetaTable(INamingContainer, MetaTable, Object)

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable) TryGetMetaTable(INamingContainer, MetaTable)

Determina si están disponibles los metadatos de la tabla.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type) EnableDynamicData(INamingContainer, Type)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object) EnableDynamicData(INamingContainer, Type, Object)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.Enables Dynamic Data behavior for the specified data control.

Se aplica a

Consulte también: