LiteralMode Enumeración
Definición
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í.
Especifica cómo se representa el contenido de un control Literal.
public enum class LiteralModepublic enum LiteralModetype LiteralMode = Public Enum LiteralMode- Herencia
Campos
| Encode | 2 | El contenido del control literal está codificado en HTML. |
| PassThrough | 1 | El contenido del control literal no está modificado. |
| Transform | 0 | Se quitan los elementos de lenguaje de marcado no compatibles del control literal. Si el control literal se representa en un explorador que admite HTML o XHTML, no se modificará su contenido. |
Ejemplos
En el ejemplo siguiente se muestra cómo establecer la Literal.Mode propiedad . Inicialmente se establece Encode en en la sintaxis declarativa del control . Una vez que se cargue la página, el usuario puede hacer clic en un botón para establecer la Mode propiedad en PassThrough. Esto hace que el contenido de la Literal.Text propiedad se represente de forma diferente.
<%@ Page Language="VB" %>
<!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.Mode Property Example</title>
<script runat="Server">
Sub PassThroughButton_Click(ByVal sender As Object, ByVal e As EventArgs)
Literal1.Mode = LiteralMode.PassThrough
Label1.Text = "The contents of the Literal.Text property " + _
"passed through to the browser:"
End Sub
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>Literal.Mode Property Example</h3>
<asp:Label ID="Label1"
Text="The HTML-encoded contents of the Literal.Text property:"
runat="server">
</asp:Label><br /><br />
<asp:Literal ID="Literal1"
Mode="Encode"
Text= "<b>bold</b><br/><i>italic</i><br/>"
runat="server">
</asp:Literal>
<hr />
<asp:Button ID="PassThroughButton"
Text="Pass Through Mode"
OnClick="PassThroughButton_Click"
runat="server">
</asp:Button>
</form>
</body>
</html>
Comentarios
La LiteralMode enumeración representa los modos que puede especificar para cómo se representa el contenido de un Literal control. La Literal.Mode propiedad usa estos valores de enumeración para establecer el comportamiento del contenido de la Literal.Text propiedad .
Si especifica PassThrough, todo el contenido de la Literal.Text propiedad se pasa al dispositivo o explorador sin modificaciones. Por ejemplo, si la Literal.Text propiedad contiene una <hr> etiqueta, se envía a todos los dispositivos y exploradores independientemente de si se admite.
Si especifica Encode, el contenido de la Text propiedad se convierte en una cadena codificada en HTML antes de la representación. Por ejemplo, si la Literal.Text propiedad contiene una <hr> etiqueta, se convertirá <hr> en y se enviará al dispositivo o al explorador.
Si especifica Transform, el comportamiento de representación de la Literal.Text propiedad depende del tipo de marcado que se representa. Cuando el Literal control se representa para un dispositivo o explorador que admite HTML o XHTML, especificar Transform genera el mismo comportamiento que la especificación PassThroughde . Todas las etiquetas y elementos de marcado de la Literal.Text propiedad se representan para el explorador solicitante.
Cuando el Literal control se representa para un lenguaje de marcado distinto de HTML o XHTML, como WML o cHTML, puede usar el Transform valor para quitar elementos de marcado no admitidos. En este caso, los elementos del lenguaje de marcado de la Literal.Text propiedad que no se admiten en el lenguaje de marcado de destino no se representan para el control. Por ejemplo, si la Literal.Text propiedad contiene una <hr> etiqueta, la etiqueta se quita antes de enviar el contenido a un dispositivo WML. Si una etiqueta no admitida contiene contenido, solo se quita la etiqueta y el contenido se envía al dispositivo o explorador. Por ejemplo, si la Literal.Text propiedad contiene el contenido <XYZ>Test</XYZ>, las <XYZ> etiquetas y </XYZ> se quitan mientras se envía el texto Test al dispositivo o explorador.
