Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase Literal

 

Publicado: octubre de 2016

Reserva una ubicación en la página web para mostrar texto estático.

Espacio de nombres:   System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.Literal
      System.Web.UI.WebControls.Localize

public class Literal : Control, ITextControl

NombreDescripción
System_CAPS_pubmethodLiteral()

Inicializa una nueva instancia de la clase Literal.

NombreDescripción
System_CAPS_protpropertyAdapter

Obtiene el adaptador específico del explorador para el control.(Heredado de Control).

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativa a la aplicación de la Page o UserControl objeto que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyBindingContainer

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el control que contiene el enlace de datos del control.(Heredado de Control).

System_CAPS_protpropertyChildControlsCreated

Obtiene un valor que indica si se crearon los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubpropertyClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.(Heredado de Control).

System_CAPS_pubpropertyClientIDMode

Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad.(Heredado de Control).

System_CAPS_protpropertyClientIDSeparator

Obtiene un valor de carácter que representa el carácter separador utilizado en el ClientID propiedad.(Heredado de Control).

System_CAPS_protpropertyContext

Obtiene el HttpContext objeto asociado con el control de servidor para la solicitud Web actual.(Heredado de Control).

System_CAPS_pubpropertyControls

Obtiene un ControlCollection objeto que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.(Heredado de Control).

System_CAPS_pubpropertyDataItemContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataItemContainer.(Heredado de Control).

System_CAPS_pubpropertyDataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataKeysControl.(Heredado de Control).

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.(Heredado de Control).

System_CAPS_pubpropertyEnableTheming

Obtiene o establece un valor que indica si se aplican temas a este control.(Heredado de Control).

System_CAPS_pubpropertyEnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.(Heredado de Control).

System_CAPS_protpropertyEvents

Obtiene una lista de delegados de controladores de eventos para el control. Esta propiedad es de sólo lectura.(Heredado de Control).

System_CAPS_protpropertyHasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardado.(Heredado de Control).

System_CAPS_pubpropertyID

Obtiene o establece el identificador de programación asignado al control de servidor.(Heredado de Control).

System_CAPS_protpropertyIdSeparator

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el carácter utilizado para separar los identificadores de control.(Heredado de Control).

System_CAPS_protpropertyIsChildControlStateCleared

Obtiene un valor que indica si los controles incluidos en este control tienen estado de control.(Heredado de Control).

System_CAPS_protpropertyIsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios en su estado de vista.(Heredado de Control).

System_CAPS_protpropertyIsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.(Heredado de Control).

System_CAPS_protpropertyLoadViewStateByID

Obtiene un valor que indica si el control participa en la carga su estado de vista por ID en lugar de índice.(Heredado de Control).

System_CAPS_pubpropertyMode

Obtiene o establece un valor de enumeración que especifica cómo el contenido en el Literal representa el control.

System_CAPS_pubpropertyNamingContainer

Obtiene una referencia al control de servidor de nombres del contenedor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor con el mismo Control.ID valor de propiedad.(Heredado de Control).

System_CAPS_pubpropertyPage

Obtiene una referencia a la Page instancia que contiene el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyParent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.(Heredado de Control).

System_CAPS_pubpropertyRenderingCompatibility

Obtiene un valor que especifica será compatible con la versión de ASP.NET que se representa en HTML.(Heredado de Control).

System_CAPS_pubpropertySite

Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño.(Heredado de Control).

System_CAPS_pubpropertySkinID

Obtiene o establece la máscara que se aplica al control.(Heredado de Control).

System_CAPS_pubpropertyTemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyTemplateSourceDirectory

Obtiene el directorio virtual de la Page o UserControl que contiene el control de servidor actual.(Heredado de Control).

System_CAPS_pubpropertyText

Obtiene o establece el título que se muestra en el Literal control.

System_CAPS_pubpropertyUniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el Explorador de valores potencialmente peligrosos.(Heredado de Control).

System_CAPS_protpropertyViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor a través de varias solicitudes de la misma página.(Heredado de Control).

System_CAPS_protpropertyViewStateIgnoresCase

Obtiene un valor que indica si la StateBag objeto distingue mayúsculas de minúsculas.(Heredado de Control).

System_CAPS_pubpropertyViewStateMode

Obtiene o establece el modo de estado de vista de este control.(Heredado de Control).

System_CAPS_pubpropertyVisible

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

NombreDescripción
System_CAPS_protmethodAddedControl(Control, Int32)

Se llama después de que se agrega un control secundario a la Controls colección de la Control objeto.(Heredado de Control).

System_CAPS_protmethodAddParsedSubObject(Object)

Notifica al control Literal que se analizó un elemento XML o HTML y agrega ese elemento a ControlCollection del control del servidor.(Invalida Control.AddParsedSubObject(Object)).

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Se aplica a las propiedades de estilo definidas en la hoja de estilo de página para el control.(Heredado de Control).

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Comienza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Recopila información sobre el control de servidor y la pasa a la Trace propiedad que se mostrará cuando el seguimiento está habilitado para la página.(Heredado de Control).

System_CAPS_protmethodClearCachedClientID()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece la caché ClientID valor a null.(Heredado de Control).

System_CAPS_protmethodClearChildControlState()

Elimina la información de estado de control para los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildState()

Elimina la información de estado de vista y el estado de control para los controles secundarios todos del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildViewState()

Elimina la información de estado de vista para todo el servidor controles secundarios del control.(Heredado de Control).

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece el ClientIDMode propiedad de la instancia actual del control y de todos los controles secundarios a Inherit.(Heredado de Control).

System_CAPS_protmethodCreateChildControls()

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.(Heredado de Control).

System_CAPS_protmethodCreateControlCollection()

Crea un objeto EmptyControlCollection para la instancia actual del control Literal.(Invalida Control.CreateControlCollection()).

System_CAPS_pubmethodDataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.(Heredado de Control).

System_CAPS_protmethodDataBind(Boolean)

Enlaza un origen de datos para el control de servidor invocado y todos sus controles secundarios con una opción para generar el DataBinding eventos.(Heredado de Control).

System_CAPS_protmethodDataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubmethodDispose()

Habilita un control de servidor realizar la limpieza final antes de que se libere de la memoria.(Heredado de Control).

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Finaliza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodEnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios.(Heredado de Control).

System_CAPS_protmethodEnsureID()

Crea un identificador para los controles que no tienen un identificador asignado.(Heredado de Control).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodFindControl(String)

Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id parámetro.(Heredado de Control).

System_CAPS_protmethodFindControl(String, Int32)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id y un entero especificado en el pathOffset parámetro, lo que ayuda en la búsqueda. No se debe reemplazar esta versión de la FindControl (método).(Heredado de Control).

System_CAPS_pubmethodFocus()

Establecer el foco de entrada a un control; el Focus no se admite el método de control de base en un Literal control.(Invalida Control.Focus()).

System_CAPS_protmethodGetDesignModeState()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene los datos de tiempo de diseño para un control.(Heredado de Control).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(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).

System_CAPS_pubmethodGetRouteUrl(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).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Devuelve la parte fija de la UniqueID propiedad del control especificado.(Heredado de Control).

System_CAPS_pubmethodHasControls()

Determina si el control de servidor contiene todos los controles secundarios.(Heredado de Control).

System_CAPS_protmethodHasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.(Heredado de Control).

System_CAPS_protmethodIsLiteralContent()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Determina si el control de servidor alberga únicamente contenido literal.(Heredado de Control).

System_CAPS_protmethodLoadControlState(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).

System_CAPS_protmethodLoadViewState(Object)

Restaura la información de estado de vista de una solicitud de página anterior guardada por el SaveViewState (método).(Heredado de Control).

System_CAPS_protmethodMapPathSecure(String)

Recupera la ruta de acceso física que se asigna una ruta de acceso virtual absoluta o relativa, a.(Heredado de Control).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodOnBubbleEvent(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.(Heredado de Control).

System_CAPS_protmethodOnDataBinding(EventArgs)

Genera el evento DataBinding.(Heredado de Control).

System_CAPS_protmethodOnInit(EventArgs)

Genera el evento Init.(Heredado de Control).

System_CAPS_protmethodOnLoad(EventArgs)

Genera el evento Load.(Heredado de Control).

System_CAPS_protmethodOnPreRender(EventArgs)

Genera el evento PreRender.(Heredado de Control).

System_CAPS_protmethodOnUnload(EventArgs)

Genera el evento Unload.(Heredado de Control).

System_CAPS_protmethodOpenFile(String)

Obtiene un Stream utilizado para leer un archivo.(Heredado de Control).

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al elemento primario del control.(Heredado de Control).

System_CAPS_protmethodRemovedControl(Control)

Se llama después de que se quita un control secundario de la Controls colección de la Control objeto.(Heredado de Control).

System_CAPS_protmethodRender(HtmlTextWriter)

Envía el contenido del control de servidor al objeto HtmlTextWriter proporcionado, que escribe el contenido que se representará en el cliente.(Invalida Control.Render(HtmlTextWriter)).

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un HtmlTextWriter objeto, que escribe el contenido que se va a representar en el cliente.(Heredado de Control).

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Genera el contenido del control de servidor a un HtmlTextWriter de objeto y almacena información de seguimiento sobre el control si está habilitado el seguimiento.(Heredado de Control).

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Genera el contenido del control de servidor a un HtmlTextWriter objeto usando una URL ControlAdapter objeto.(Heredado de Control).

System_CAPS_protmethodResolveAdapter()

Obtiene el adaptador de control responsable de representar el control especificado.(Heredado de Control).

System_CAPS_pubmethodResolveClientUrl(String)

Obtiene una dirección URL que se puede usar el explorador.(Heredado de Control).

System_CAPS_pubmethodResolveUrl(String)

Convierte una dirección URL en una que se puede usar en el cliente solicitante.(Heredado de Control).

System_CAPS_protmethodSaveControlState()

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.(Heredado de Control).

System_CAPS_protmethodSaveViewState()

Guarda los cambios realizados en el estado de vista del control de servidor desde que la página volvió a publicarse en el servidor.(Heredado de Control).

System_CAPS_protmethodSetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.(Heredado de Control).

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando la clave de datos de seguimiento y el valor de datos de seguimiento de seguimiento.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando el objeto de seguimiento, la clave de datos de seguimiento y el valor de datos de seguimiento de traza.(Heredado de Control).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_protmethodTrackViewState()

Hace el seguimiento de cambios de estado de vista para el control de servidor para que puedan almacenarse en el control de servidor StateBag objeto. Este objeto es accesible a través de la propiedad Control.ViewState.(Heredado de Control).

NombreDescripción
System_CAPS_pubeventDataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.(Heredado de Control).

System_CAPS_pubeventDisposed

Se produce cuando un control de servidor se libera de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página ASP.NET.(Heredado de Control).

System_CAPS_pubeventInit

Se produce cuando se inicializa el control de servidor, que es el primer paso del ciclo de vida.(Heredado de Control).

System_CAPS_pubeventLoad

Se produce cuando el control de servidor se carga en el Page objeto.(Heredado de Control).

System_CAPS_pubeventPreRender

Se produce después de la Control es cargado pero antes de la representación.(Heredado de Control).

System_CAPS_pubeventUnload

Se produce cuando el control de servidor se descarga de la memoria.(Heredado de Control).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para una descripción de este miembro, vea IParserAccessor.AddParsedSubObject.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para una descripción de este miembro, vea IControlDesignerAccessor.UserData.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.DataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para una descripción de este miembro, vea IExpressionsAccessor.Expressions.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para una descripción de este miembro, vea IExpressionsAccessor.HasExpressions.(Heredado de Control).

NombreDescripción
System_CAPS_pubmethodFindDataSourceControl()

Devuelve el origen de datos que está asociado con el control de datos para el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindFieldTemplate(String)

Devuelve que el contenedor de nomenclatura de la plantilla de campo para la columna especificada en el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindMetaTable()

Devuelve el objeto de metatabla para el control de datos que contiene.(Definido por DynamicDataExtensions).

Utilice el System.Web.UI.WebControls.Literal control para reservar una ubicación en la página Web para mostrar texto. El Literal control es similar a la Label control, excepto el Literal control no permite aplicar un estilo al texto mostrado. Se puede controlar mediante programación el texto mostrado en el control estableciendo la Text propiedad.

System_CAPS_cautionPrecaución

Este control se puede utilizar para mostrar los datos proporcionados por el usuario, que pueden incluir script de cliente malintencionado. Compruebe que cualquier información que se envía desde un cliente de secuencias de comandos ejecutables, instrucciones SQL u otro código antes de mostrarla en la aplicación. ASP.NET proporciona una característica de validación de solicitudes de entrada para bloquear secuencias de comandos y código HTML en la entrada del usuario. También se proporcionan controles de servidor de validación para evaluar la entrada del usuario.

Para obtener más información acerca de la seguridad, consulte Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, y Validating User Input in ASP.NET Web Pages.

<asp:Literal
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    Mode="Transform|PassThrough|Encode"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Text="string"
    Visible="True|False"
/>

En el ejemplo siguiente se muestra cómo utilizar el Literal control para mostrar texto estático.

System_CAPS_noteNota

En el ejemplo siguiente se utiliza el modelo de código de un solo archivo y podría no funcionar correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío con la extensión .aspx. Para obtener más información sobre el modelo de código de formularios Web Forms, vea ASP.NET Web Forms Page Code Model.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Literal Example</title>
<script runat="server">

      void ButtonClick(Object sender, EventArgs e)
      {
         Literal1.Text="Welcome to ASP.NET!!";
      }

   </script>

</head>
<body>
   <form id="form1" runat="server">
      <h3>Literal Example</h3>

      <asp:Literal id="Literal1"
           Text="Hello World!!"
           runat="server"/>

      <br /><br />

      <asp:Button id="Button1"
           Text="Change Literal Text"
           OnClick="ButtonClick"
           runat="server"/>

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

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: