Gewusst wie: Hinzufügen von Localize-Webserver-Steuerelementen zu ASP.NET-Webseiten (Visual Studio)

Aktualisiert: November 2007

Sie können einer ASP.NET-Webseite ein Localize-Webserver-Steuerelement hinzufügen, wenn in einem bestimmten Bereich der Seite lokalisierter Text angezeigt werden soll. Das Localize-Steuerelement ist mit dem Literal-Webserver-Steuerelement identisch und ähnelt dem Label-Webserver-Steuerelement. Während mit dem Label-Steuerelement ein Format auf den angezeigten Text angewendet werden kann, ist dies mit dem Localize-Steuerelement nicht möglich. Der im Localize-Steuerelement angezeigte Text kann durch Festlegen der vom Literal-Steuerelement geerbten Text-Eigenschaft programmgesteuert festgelegt werden. Weitere Informationen hierzu finden Sie unter Übersicht über das Literal-Webserversteuerelement.

So fügen Sie einer ASP.NET-Webseite ein Localize-Webserver-Steuerelement hinzu

  1. Ziehen Sie von der Registerkarte Standard der Toolbox ein Localize-Steuerelement auf die Seite.

  2. Optional können Sie die Mode-Eigenschaft auf Transform, PassThrough oder Encode festlegen. Die Mode-Eigenschaft gibt an, wie das Steuerelement Markup behandelt, das Sie hinzufügen. Ausführliche Informationen finden Sie unter Übersicht über das Localize-Webserver-Steuerelement.

  3. Fügen Sie der Seite Code hinzu, um die Text-Eigenschaft des Steuerelements zur Laufzeit festzulegen.

    Im nachstehenden Codebeispiel wird gezeigt, wie Sie Text und Codierung des Localize-Steuerelements programmgesteuert festlegen. Die Seite enthält Optionsfelder, mit denen der Benutzer zwischen codiertem und Pass-Through-Text wählen kann.

    Ein Codebeispiel, in dem Ressourcenzeichenfolgen verwendet werden, finden Sie unter Deklarative Syntax des Localize-Webserver-Steuerelements.

    Hinweis:

    Wenn Sie die Text-Eigenschaft auf Text festlegen, den Sie von einer nicht vertrauenswürdigen Quelle erhalten haben, legen Sie die Mode-Eigenschaft des Steuerelements auf Encode fest, damit das Markup nicht ausgeführt werden kann.

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

Siehe auch

Konzepte

Übersicht über das Localize-Webserver-Steuerelement

Referenz

Deklarative Syntax des Localize-Webserver-Steuerelements

Localize

  • Last updated on