LiteralMode Enumeración

Referencia

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

Especifica cómo se representa el contenido de un control Literal.

public enum class LiteralMode

public enum LiteralMode

type LiteralMode =

Public Enum LiteralMode

Herencia: Object

ValueType

Enum
LiteralMode

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 cargada 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 explorador.

Si especifica Transform, el comportamiento de representación de la Literal.Text propiedad depende del tipo de marcado que se va a representar. Cuando el Literal control se representa para un dispositivo o explorador que admite HTML o XHTML, especificar Transform genera el mismo comportamiento que especificar PassThrough. 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 el texto Test se envía al dispositivo o explorador.

Se aplica a