LiteralMode Enumeração

Definição

Especifica como o conteúdo em um controle Literal é renderizado.

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Herança
LiteralMode

Campos

Encode 2

Os conteúdos do controle literal estão codificados em HTML.

PassThrough 1

Os conteúdos do controle literal não são modificados.

Transform 0

Os elementos de linguagem de marcação incompatíveis do controle literal são removidos. Se o controle literal for processado em um navegador compatível com HTML ou XHTML, o conteúdo do controle não será modificado.

Exemplos

O exemplo a seguir demonstra como definir a Literal.Mode propriedade. Inicialmente, ele é definido Encode como na sintaxe declarativa para o controle. Depois que a página é carregada, o usuário pode clicar em um botão para definir a Mode propriedade como PassThrough. Isso faz com que o conteúdo da propriedade seja renderizado de Literal.Text forma diferente.

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

Comentários

A LiteralMode enumeração representa os modos que você pode especificar para como o conteúdo em um Literal controle é renderizado. A Literal.Mode propriedade usa esses valores de enumeração para definir o comportamento do conteúdo da Literal.Text propriedade.

Se você especificar PassThrough, todo o conteúdo da Literal.Text propriedade será passado para o dispositivo ou navegador sem modificações. Por exemplo, se a Literal.Text propriedade contiver uma <hr> marca, ela será enviada para todos os dispositivos e navegadores, independentemente de ter suporte.

Se você especificar Encode, o conteúdo da Text propriedade será convertido em uma cadeia de caracteres codificada em HTML antes da renderização. Por exemplo, se a Literal.Text propriedade contiver uma <hr> marca, ela será convertida &lt;hr&gt; e enviada para o dispositivo ou navegador.

Se você especificar Transform, o comportamento de renderização da Literal.Text propriedade dependerá do tipo de marcação que está sendo renderizada. Quando o Literal controle é renderizado para um dispositivo ou navegador que dá suporte a HTML ou XHTML, especificar Transform produz o mesmo comportamento que especificar PassThrough. Todas as marcas de marcação e elementos da Literal.Text propriedade são renderizados para o navegador solicitante.

Quando o Literal controle é renderizado para uma linguagem de marcação diferente de HTML ou XHTML, como WML ou cHTML, você pode usar o Transform valor para remover elementos de marcação sem suporte. Nesse caso, quaisquer elementos de linguagem de marcação da Literal.Text propriedade que não têm suporte na linguagem de marcação de destino não são renderizados para o controle. Por exemplo, se a Literal.Text propriedade contiver uma <hr> marca, a marca será removida antes que o conteúdo seja enviado para um dispositivo WML. Se uma marca sem suporte contiver conteúdo, apenas a marca será removida e o conteúdo será enviado para o dispositivo ou navegador. Por exemplo, se a Literal.Text propriedade contiver o conteúdo<XYZ>Test</XYZ>, as marcas e </XYZ> as <XYZ> marcas serão removidas enquanto o texto Test é enviado para o dispositivo ou navegador.

Aplica-se a

Confira também