Literal.Mode (Propiedad)
Obtiene o establece un valor de enumeración que especifica cómo se representa el contenido del control Literal.

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

Sintaxis

Visual Basic (Declaración)
Public Property Mode As LiteralMode
Visual Basic (Uso)
Dim instance As Literal
Dim value As LiteralMode

value = instance.Mode

instance.Mode = value
C#
public LiteralMode Mode { get; set; }
C++
public:
property LiteralMode Mode {
    LiteralMode get ();
    void set (LiteralMode value);
}
J#
/** @property */
public LiteralMode get_Mode ()

/** @property */
public void set_Mode (LiteralMode value)
JScript
public function get Mode () : LiteralMode

public function set Mode (value : LiteralMode)
XAML
No aplicable.

Valor de propiedad

Uno de los valores de la enumeración LiteralMode. El valor predeterminado es Transform.
Excepciones

Tipo de excepciónCondición

ArgumentOutOfRangeException

El tipo especificado no se corresponde con ninguno de los valores de la enumeración LiteralMode.

Comentarios

Utilice la propiedad Mode para especificar cómo se debe representar el contenido de un control Literal. Esta propiedad se establece mediante uno de los valores de enumeración LiteralMode. En la siguiente tabla se enumeran los posibles valores.

Valor

Descripción

PassThrough

No se modifica el contenido del control.

Encode

El contenido del control se convierte en una cadena codificada en HTML.

Transform

Los elementos del lenguaje de marcado no compatibles se quitan del contenido del control. Si el control Literal se representa en un explorador que admite HTML o XHTML, no se modifica el contenido de control.

Si especifica PassThrough, el contenido completo de la propiedad Text se pasa al dispositivo o explorador sin ninguna modificación. Por ejemplo, si la propiedad Text de un control Literal contiene una etiqueta <hr>, se envía a todos los dispositivos y exploradores ya sea o no compatible.

Si especifica Encode, el contenido de la propiedad Text se convierte en una cadena codificada en HTML antes de representarse. Por ejemplo, si la propiedad Text de un control Literal contiene una etiqueta <hr>, primero se convierte en &lt;Hr&gt; y luego se envía al dispositivo o explorador.

Si especifica Transform, el comportamiento de representación de la propiedad Text depende del tipo de marcado que se va a representar. Cuando se representa el control Literal para un dispositivo o explorador que admite HTML o XHTML, al especificar Transform, se genera el mismo comportamiento que al especificar PassThrough. Todas las etiquetas de marcado y elementos de la propiedad Text se representan para el explorador que realizó la solicitud.

Cuando se representa el control Literal para un lenguaje de marcado distinto de HTML o XHTML, como WML o cHTML, puede utilizar el valor Transform para quitar los elementos de marcado no compatibles. En este caso, los elementos de lenguaje de marcado de la propiedad Text no admitidos en el lenguaje de marcado de destino no se representan para el control. Por ejemplo, si la propiedad Text de un control Literal contiene una etiqueta <hr>, se quita la etiqueta antes de que se envíe el contenido a un dispositivo WML. Si una etiqueta no compatible contiene contenido, sólo se quita la etiqueta, y se envía al contenido al dispositivo o explorador. Por ejemplo, si la propiedad Text contiene el contenido <XYZ>Test</XYZ>, las etiquetas <XYZ> y </XYZ> se quitan, y el texto "Test" se envía al dispositivo o explorador.

Ejemplo

En el ejemplo de código siguiente se muestra cómo establecer la propiedad Mode de un control Literal. La propiedad Mode se establece inicialmente en Encode en la sintaxis declarativa para el control. Una vez cargada la página, el usuario puede hacer clic en un botón para establecer la propiedad Mode en PassThrough. Esto hace que el contenido de la propiedad Text se represente de manera diferente.

NotaNota:

En el ejemplo de código siguiente se utiliza el modelo de código de un solo archivo que podría no funcionar correctamente si se copia directamente en un archivo de código subyacente. Se debe copiar este código de ejemplo en un archivo de texto vacío con una extensión .aspx. Para obtener más información sobre el modelo de código de los formularios Web Forms, vea Modelo de código de las páginas Web ASP.NET.

Visual Basic
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
<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>
Plataformas

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

Información de versión

.NET Framework

Compatible con: 3.0, 2.0
Vea también

Page view tracker