Condividi tramite

Procedura: aggiungere controlli server Web Localize a pagine Web ASP.NET (Visual Studio)

  • Articolo

Aggiornamento: novembre 2007

È possibile aggiungere un controllo server Web Localize alla pagina Web ASP.NET quando si desidera visualizzare un testo localizzato in una determinata area della pagina. Il controllo Localize è identico al controllo server Web Literal e simile al controllo server Web Label. A differenza del controllo Label, il controllo Localize non consente di applicare uno stile al testo visualizzato. È possibile controllare a livello di codice il testo visualizzato nel controllo Localize impostando la proprietà Text, ereditata dal controllo Literal. Per ulteriori informazioni, vedere Cenni preliminari sul controllo server Web Literal.

Per aggiungere un controllo server Web Localize a una pagina Web ASP.NET

  1. Dalla scheda Standard della Casella degli strumenti trascinare un controllo Localize nella pagina.

  2. Se lo si desidera, impostare la proprietà Mode su Transform, PassThrough o Encode. La proprietà Mode definisce il modo in cui vengono gestiti i tag aggiunti al controllo. Per informazioni dettagliate, vedere Cenni preliminare sul controllo server Web Localize.

  3. Aggiungere alla pagina il codice per impostare la proprietà Text del controllo in fase di esecuzione.

    Nell'esempio di codice riportato di seguito viene illustrato come impostare a livello di codice il testo e la codifica del controllo Localize. Nella pagina sono inclusi i pulsanti di opzione che consentono all'utente di scegliere fra testo codificato e testo pass-through.

    Per un esempio di codice in cui vengono utilizzate stringhe di risorsa, vedere Sintassi dichiarativa per il controllo server Web Localize.

    Nota:

    Se si imposta la proprietà Text su un testo proveniente da un'origine non attendibile, impostare la proprietà Mode del controllo su Encode in modo che il codice non sia eseguibile.

    		 
    <%@ 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>

Vedere anche

Concetti

Cenni preliminare sul controllo server Web Localize

Riferimenti

Sintassi dichiarativa per il controllo server Web Localize

Localize