Información general sobre Literal (Control de servidor Web)
Actualización: noviembre 2007
Puede utilizar un control Literal de servidor Web como un contenedor para otros contenidos de la página.
Este tema contiene:
Escenarios
Background
Ejemplos de código
Referencia de clase
Escenarios
El control Literal se utiliza principalmente cuando el contenido se agrega a la página de forma dinámica.
Volver al principio
Background
El control Literal representa una de las diferentes opciones que existen para agregar contenido a una página. Si se trata de contenido estático, puede agregar el marcado directamente a una página como HTML, sin utilizar un contenedor. Sin embargo, si desea agregar el contenido dinámicamente, debe agregar el contenido a un contenedor. Los contenedores típicos son el control Label, el control Literal, el control Panel y el control PlaceHolder.
El control Literal se diferencia del control Label en que el control Literal no agrega ningún elemento HTML al texto. (El control Label representa un elemento span.) En consecuencia, el control Literal no admite ningún atributo de estilo, incluidos los atributos de posición. Sin embargo, el control Literal permite especificar si el contenido está codificado.
Los controles Panel y PlaceHolder se representan como elementos div, que crean bloques discretos en la página, en lugar de representarse en línea como los controles Label y Literal.
En general, utilice un control Literal cuando desee representar texto y controles directamente en una página sin ningún marcado adicional.
Codificar el contenido en el control Literal
El control Literal admite la propiedad Mode que especifica de qué modo administra el control el marcado que se agrega. Puede establecer la propiedad Mode en estos valores:
Transform. Cualquier marcado que agregue al control se transforma para adaptarse al protocolo del explorador que realizó la solicitud. Esta configuración es útil si está representando el contenido en dispositivos móviles que utilizan un protocolo distinto de HTML.
PassThrough. Cualquier marcado que agregue al control se representa tal cual en el explorador.
Encode. Cualquier marcado que agregue al control se codifica mediante el método HtmlEncode, que convierte la codificación HTML en su representación de texto. Por ejemplo, una etiqueta <b> se representa como <b>. La codificación es útil cuando desea que el explorador muestre el marcado en lugar de interpretarlo. La codificación también es útil para la seguridad, para evitar que se ejecute marcado malintencionado en el explorador. Se recomienda si se muestran cadenas desde un origen que no es de confianza. Para obtener más información, vea Cómo: Proteger una aplicación Web frente a ataques mediante secuencias de comandos aplicando codificación HTML a las cadenas.
Ejemplos de código
Referencia de clase
En la tabla siguiente se enumeran las clases que se relacionan con el control Literal.
Member |
Descripción |
|---|---|
Clase principal del control. |
Volver al principio