LiteralMode Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica como o conteúdo num Literal controlo é renderizado.
public enum class LiteralModepublic enum LiteralModetype LiteralMode = Public Enum LiteralMode- Herança
Campos
| Name | Valor | Description |
|---|---|---|
| Transform | 0 | Os elementos da linguagem de marcação não suportados do controlo literal são removidos. Se o controlo literal for renderizado num navegador que suporta HTML ou XHTML, o conteúdo do controlo não é modificado. |
| PassThrough | 1 | O conteúdo literal do controlo não é modificado. |
| Encode | 2 | O conteúdo do controlo literal é codificado em HTML. |
Exemplos
O exemplo seguinte demonstra como definir a Literal.Mode propriedade. Inicialmente, está definido como Encode na sintaxe declarativa do controlo. Depois de a página carregar, o utilizador pode clicar num botão para definir a Mode propriedade para PassThrough. Isto faz com que o conteúdo da Literal.Text propriedade fique renderizado de 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>
Observações
A LiteralMode enumeração representa os modos que pode especificar para a forma como o conteúdo num Literal controlo é renderizado. A Literal.Mode propriedade utiliza estes valores de enumeração para definir o comportamento do conteúdo da Literal.Text propriedade.
Se especificar PassThrough, todo o conteúdo da Literal.Text propriedade é passado para o dispositivo ou navegador sem quaisquer modificações. Por exemplo, se a Literal.Text propriedade contiver uma <hr> etiqueta, ela é enviada para todos os dispositivos e browsers, independentemente de ser suportada ou não.
Se especificar Encode, o conteúdo da Text propriedade é convertido numa cadeia codificada em HTML antes da renderização. Por exemplo, se a Literal.Text propriedade contiver uma <hr> etiqueta, será convertida para <hr> e enviada para o dispositivo ou navegador.
Se especificar Transform, o comportamento de renderização da Literal.Text propriedade depende do tipo de marcação que está a ser renderizada. Quando o Literal controlo é renderizado para um dispositivo ou navegador que suporta HTML ou XHTML, especificar Transform produz o mesmo comportamento que especificar PassThrough. Todas as etiquetas de marcação e elementos da Literal.Text propriedade são renderizados para o navegador solicitante.
Quando o Literal controlo é renderizado para uma linguagem de marcação diferente de HTML ou XHTML, como WML ou cHTML, pode usar o Transform valor para remover elementos de marcação não suportados. Neste caso, quaisquer elementos Literal.Text da linguagem de marcação da propriedade que não sejam suportados na linguagem de marcação alvo não são renderizados para o controlo. Por exemplo, se a Literal.Text propriedade contiver uma <hr> etiqueta, a etiqueta é removida antes do conteúdo ser enviado para um dispositivo WML. Se uma etiqueta não suportada contiver conteúdo, apenas a etiqueta é removida e o conteúdo é enviado para o dispositivo ou navegador. Por exemplo, se a Literal.Text propriedade contiver o conteúdo <XYZ>Test</XYZ>, as <XYZ> etiquetas e </XYZ> são removidas enquanto o texto Test é enviado para o dispositivo ou navegador.