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 <b>.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 |
---|---|
A classe principal para o controle. |
Voltar ao topo