다음을 통해 공유

방법: ASP.NET 웹 페이지에 Localize 웹 서버 컨트롤 추가(Visual Studio)

  • 아티클

업데이트: 2007년 11월

페이지의 특정 영역에 지역화된 텍스트를 표시하려는 경우 ASP.NET 웹 페이지에 Localize 웹 서버 컨트롤을 추가할 수 있습니다. Localize 컨트롤은 Literal 웹 서버 컨트롤과 동일하며 Label 웹 서버 컨트롤과 유사합니다. 표시되는 텍스트에 스타일을 적용할 수 있는 Label 컨트롤과 달리 Localize 컨트롤을 사용하면 텍스트에 스타일을 적용할 수 없습니다. Literal 클래스에서 상속되는 Text 속성을 설정하면 Localize 컨트롤에 표시되는 텍스트를 프로그래밍 방식으로 제어할 수 있습니다. 자세한 내용은 Literal 웹 서버 컨트롤 개요를 참조하십시오.

Localize 웹 서버 컨트롤을 ASP.NET 웹 페이지에 추가하려면

  1. 도구 상자의 표준 탭에서 Localize 컨트롤을 페이지로 끌어 옵니다.

  2. 필요에 따라 Mode 속성을 Transform, PassThrough 또는 Encode로 설정합니다. Mode 속성은 사용자가 추가한 태그가 컨트롤에서 처리되는 방법을 지정합니다. 자세한 내용은 Localize 웹 서버 컨트롤 개요를 참조하십시오.

  3. 런타임에 컨트롤의 Text 속성을 설정하는 코드를 페이지에 추가합니다.

    다음 코드 예제에서는 Localize 컨트롤의 텍스트 및 인코딩을 프로그래밍 방식으로 설정하는 방법을 보여 줍니다. 이 페이지에는 사용자가 인코딩된 텍스트와 통과 텍스트 중에 선택할 수 있는 라디오 단추가 포함됩니다.

    리소스 문자열을 사용하는 코드 예제를 보려면 Localize 웹 서버 컨트롤 선언 구문을 참조하십시오.

    참고:

    Text 속성에 설정하는 텍스트가 출처를 신뢰할 수 없는 텍스트이면 컨트롤의 Mode 속성을 Encode로 설정하여 이 태그를 실행할 수 없도록 합니다.

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

참고 항목

개념

Localize 웹 서버 컨트롤 개요

참조

Localize 웹 서버 컨트롤 선언 구문

Localize