Literal.Mode Propiedad
Definición
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 Literal control.
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, setPublic Property Mode As LiteralModeValor de propiedad
Uno de los LiteralMode valores de enumeración. El valor predeterminado es Transform.
Excepciones
El tipo especificado no es uno de los LiteralMode valores de enumeración.
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 Formularios Web Forms, consulte 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.
| Importancia | 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 ninguna modificación. Por ejemplo, si la Text propiedad de un Literal control contiene una <hr> etiqueta, se envía a todos los dispositivos y exploradores si se admite o 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 en <Hr> y se envía al dispositivo o al 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 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 de 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.
