Literal.Mode Propiedad

Definición

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

public:
 property System::Web::UI::WebControls::LiteralMode Mode { System::Web::UI::WebControls::LiteralMode get(); void set(System::Web::UI::WebControls::LiteralMode value); };
public System.Web.UI.WebControls.LiteralMode Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.LiteralMode with get, set
Public Property Mode As LiteralMode

Valor de propiedad

Uno de los valores de enumeración de LiteralMode. De manera predeterminada, es Transform.

Excepciones

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la propiedad de Mode un Literal control. La Mode propiedad se establece Encode inicialmente 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 Text propiedad se represente de forma diferente.

Nota:

En el ejemplo siguiente se usa el modelo de código de un solo archivo y es posible que no funcione 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 que tenga una extensión .aspx. Para obtener más información sobre el modelo de código de Web Forms, consulte ASP.NET Web Forms modelo de código de página.

<%@ 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

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

Value Descripción
PassThrough El contenido del control no se modifica.
Encode El contenido del control se convierte en una cadena codificada en HTML.
Transform Los elementos del lenguaje de marcado no admitidos se quitan del contenido del control. Si el Literal control se representa en un explorador que admite HTML o XHTML, el contenido del control no se modifica.

Si especifica PassThrough, todo el contenido de la Text propiedad se pasa al dispositivo o explorador sin realizar modificaciones. Por ejemplo, si la Text propiedad de un Literal control contiene una <hr> etiqueta, se envía a todos los dispositivos y exploradores tanto si se admite como si no.

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 Text propiedad de un Literal control contiene una <hr> etiqueta, se convierte &lt;Hr&gt; en y se envía al dispositivo o explorador.

Si especifica Transform, el comportamiento de representación de la 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 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 Text propiedad que no se admiten en el lenguaje de marcado de destino no se representan para el control. Por ejemplo, si la Text propiedad de un Literal control 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 Text propiedad contiene el contenido <XYZ>Test</XYZ>, las <XYZ> etiquetas y </XYZ> se quitan y el texto "Test" se envía al dispositivo o explorador.

Se aplica a

Consulte también