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)
Visual Basic (Declaración)
Public Property Mode As LiteralMode
Dim instance As Literal
Dim value As LiteralMode
value = instance.Mode
instance.Mode = value
public LiteralMode Mode { get; set; }
public:
property LiteralMode Mode {
LiteralMode get ();
void set (LiteralMode value);
}
/** @property */
public LiteralMode get_Mode ()
/** @property */
public void set_Mode (LiteralMode value)
public function get Mode () : LiteralMode
public function set Mode (value : LiteralMode)
Valor de propiedad
Uno de los valores de la enumeración LiteralMode. El valor predeterminado es Transform.
| Tipo de excepción | Condición |
|---|
ArgumentOutOfRangeException | El tipo especificado no se corresponde con ninguno de los valores de la enumeración LiteralMode. |
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 <Hr> 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.
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.
.gif) Nota: |
|---|
| 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. |
<%@ 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>
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.
.NET Framework
Compatible con: 3.0, 2.0