Partilhar via


Visão geral do Controle do Servidor Web Localize

The Localize Web server control lets you display localized text in a specific area on your page.

Esse tópico contém:

  • Segundo plano

  • Exemplos de código

  • Referência de Classe

  • Recursos adicionais

Segundo plano

The Localize control is identical to the Literal Web server control and similar to the Label Web server control.Although the Label control lets you apply a style to the displayed text, the Localize control does not.You can programmatically control the text that is displayed in the Localize control by setting the Text property, which is inherited from the Literal control.

Encoding Content

The Localize control supports the Mode property, which specifies how the control handles markup that you add to it.You can set the Mode property to the following values:

  • Transform  Any markup that you add to the control is transformed to accommodate the protocol of the requesting browser.Essa configuração é útil se você estiver processando conteúdo em dispositivos móveis que utilizam um protocolo diferente do HTML.

  • PassThrough  Any markup that you add to the control is rendered as-is to the browser.

  • Encode  Any markup that you add to the control is encoded using the HtmlEncode method, which converts HTML encoding into its text representation.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.Encoding is also useful for security and to help prevent malicious markup from being executed in the browser.It is recommended if you are displaying strings from an untrusted source.Para obter mais informações, consulte Como: Proteger contra exploits script em um aplicativo Web da Web, Applying HTML Encoding to Strings.

Localizing Text By Using Resource Strings

You can create localized strings to display in the Text property of the Localize control by using an explicit or implicit expression as the value of the property.Expressões são avaliadas, usando sequências de caracteres que sejam declaradas em arquivos de recurso (.resx).

Create .resx files in folders named App_GlobalResources and App_LocalResources in the root of your application.If you have to localize strings for multiple languages, you can create additional .resx files with locale information included in the file name.Por exemplo, a versão do seu arquivo de recurso francês seria nomeada ExampleLocalizedStrings.fr.resx.

For more information about expressions, see Visão Geral sobre Expressões do ASP.NET.For information about resource files, see Localizando Páginas da Web ASP.NET Usando Recursos.For a code example that uses regular expressions in the Localize control, see Localizar Servidor Web Controlar Declarative Syntax.

Voltar ao topo

Exemplos de código

Como: Adicionar Localize controles de servidor Web a páginas da Web do ASP.NET

Voltar ao topo

Referência de Classe

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

Membro

Descrição

Localize

A classe principal para o controle.

Voltar ao topo

Consulte também

Conceitos

Recursos em aplicativos da Web

Visão Geral sobre Expressões do ASP.NET

Referência

Localize

Outros recursos

Segurança de aplicativos ASP.NET em ambientes hospedados