Literal.Mode Propiedad

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

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

LiteralMode

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

Excepciones

ArgumentOutOfRangeException

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 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 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 Formularios Web Forms, vea ASP.NET modelo de código de página de formularios web Forms.

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

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

Valor	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 de 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 <Hr> 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 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 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>, se quitan las <XYZ> etiquetas y </XYZ> y el texto "Test" se envía al dispositivo o explorador.

Se aplica a

Compartir vía