Partilhar via


Visão Geral sobre o Controle Literal do Servidor Web

Você pode usar um controle Literal de servidor Web como um contêiner para outro conteúdo na página.

Esse tópico contém:

  • Cenários

  • Segundo plano

  • Exemplos de código

  • Referência de Classe

Cenários

O controle Literal é usado com mais frequência quando é adicionado conteúdo à página dinamicamente.

Voltar ao topo

Segundo plano

O controle Literal representa uma das várias opções para adicionar conteúdo a uma página.Para conteúdo estático, você pode adicionar marcação diretamente a uma página como HTML, sem usar um contêiner.No entanto, se você quiser adicionar conteúdo dinamicamente, você deve adicionar o conteúdo a um contêiner.Contêiners típicos são os controles Label, Literal, Panel e PlaceHolder.

O controle Literal difere do controle Label, pois o controle Literal não adiciona qualquer elemento HTML ao texto.(O controle Label processa um elemento span.) Como consequência, o controle Literal não suporta quaisquer atributos de estilo, incluindo atributos de posição.No entanto, o controle Literal permite que você especifique se o conteúdo é codificado.

Os controle Panel e PlaceHolder processam como elementos div, que criam blocos discretos na página, ao contrário da forma de processamento em linha que os controles Label e Literal fazem.

Em geral, use um controle Literal quando você deseja processar texto e controles diretamente em uma página sem qualquer marcação adicional.

Codificando o Conteúdo no Controle Literal

The Literal control supports the Mode property, which specifies how the control handles markup that you add to it.Você pode definir a propriedade Mode com estes valores:

  • Transform.Qualquer marcação que você adiciona ao controle é transformada para acomodar o protocolo do navegador solicitante.Essa configuração é útil se você estiver processando conteúdo em dispositivos móveis que utilizam um protocolo diferente do HTML.

  • PassThrough.Qualquer marcação que você adicione o controle é processado sistema autônomo - é o navegador.

  • Encode.Qualquer marcação que você adiciona ao controle é codificada usando o HtmlEncode método, que converte codificação HTML em sua representação de texto. For example, a <b> tag is rendered as &lt;b&gt;.A codificação é útil quando você deseja que o navegador exiba marcações em vez de interpretá-las.A codificação também é útil para segurança, para ajudar a impedir que marcação mal-intencionada seja executada no navegador .É recomendável se você estiver exibindo strings de uma fonte não confiável.Para obter mais informações, consulte Como: Proteger contra exploits script em um aplicativo Web da Web, Applying HTML Encoding to Strings.

Exemplos de código

Como: Adicionar controles de servidor Web Literal a uma página de Web Forms

Referência de Classe

A tabela seguinte lista as classes que estão relacionadas ao controle Literal.

Membro

Descrição

Literal

A classe principal para o controle.

Voltar ao topo

Consulte também

Referência

Visão geral sobre controle de servidor Web Label