Partilhar via

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

  • Artigo

Você pode adicionar um controle de servidor Web Localize à sua página ASP.NET quando você desejar exibir texto localizado em uma área específica na página.The Localize control is identical to the Literal Web server control and similar to the Label Web server control.Enquanto o controle Label permite que você aplique um estilo ao texto exibido, o controle Localize não o permite.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.Para obter mais informações, consulte Visão Geral sobre o Controle Literal do Servidor Web.

Para adicionar um controle de servidor Web Localize a uma página da Web do ASP.NET

  1. A partir da guia Padrão da Caixa de Ferramentas, arraste um controle Localize para a página.

  2. Opcionalmente, defina a propriedade Mode para Transform, PassThrough ou Encode.A propriedade Mode especifica como o controle manipula a marcação que você adicionar a ele.Para obter detalhes, consulte:Visão geral do Controle do Servidor Web Localize.

  3. Adicione código à sua página para definir a propriedade Text do controle em tempo de execução.

    O exemplo a seguir mostra como definir o texto e a codificação do controle Localize através de programação.A página contém botões de opção que permitem que o usuário escolha entre texto codificado e de passagem.

    Para um exemplo de código que usa cadeias de caracteres de recursos, veja Localizar Servidor Web Controlar Declarative Syntax.

    Observação:

    Se você definir a propriedade Text como sendo um texto que você adquiriu de uma fonte não confiável, defina a propriedade Mode do controle para Encode para que a marcação não seja executável.

    		 
    <%@ Page Language="VB" %>
<script >
    Protected Sub Page_Load(ByVal sender As Object, _
        ByVal e As System.EventArgs)
        Localize1.Text = "This <b>text</b> is inserted dynamically."
        If radioEncode.Checked = True Then
            Localize1.Mode = LiteralMode.Encode
        ElseIf radioPassthrough.Checked = True Then
            Localize1.Mode = LiteralMode.PassThrough
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
  <head id="Head1" >
    <title>Untitled Page</title>
  </head>
  <body>
    <form id="form1" >
      <div>
        <br />
        <asp:RadioButton 
          ID="radioEncode" 

          GroupName="LocalizeMode" 
          Checked="True" 
          Text="Encode" 
          AutoPostBack="True" />
        <br />
        <asp:RadioButton 
          ID="radioPassthrough" 

          GroupName="LocalizeMode" 
          Text="PassThrough" 
          AutoPostBack="True" />
        <br />
        <br />
        <asp:Localize ID="Localize1" ></asp:Localize>
      </div>
    </form>
  </body>
</html>

    <%@ Page Language="C#" %>
<script >
    protected void Page_Load(object sender, EventArgs e)
    {
        Localize1.Text = "This <b>text</b> is inserted dynamically.";
        if (radioEncode.Checked == true)
        {
            Localize1.Mode = LiteralMode.Encode;
        }
        if(radioPassthrough.Checked == true)
        {
            Localize1.Mode = LiteralMode.PassThrough;
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
  <head id="Head1" >
    <title>Untitled Page</title>
  </head>
  <body>
    <form id="form1" >
      <div>
        <br />
        <asp:RadioButton 
          ID="radioEncode" 

          GroupName="LocalizeMode" 
          Checked="True" 
          Text="Encode" 
          AutoPostBack="True" />
        <br />
        <asp:RadioButton 
          ID="radioPassthrough" 

          GroupName="LocalizeMode" 
          Text="PassThrough" 
          AutoPostBack="True" />
        <br />
        <br />
        <asp:Localize ID="Localize1" ></asp:Localize>
      </div>
    </form>
  </body>
</html>

Consulte também

Conceitos

Visão geral do Controle do Servidor Web Localize

Referência

Localizar Servidor Web Controlar Declarative Syntax

Localize