Literal.Mode 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

Literal 컨트롤의 내용이 렌더링되는 방법을 지정하는 열거형 값을 가져오거나 설정합니다.

public:
 property System::Web::UI::WebControls::LiteralMode Mode { System::Web::UI::WebControls::LiteralMode get(); void set(System::Web::UI::WebControls::LiteralMode value); };
public System.Web.UI.WebControls.LiteralMode Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.LiteralMode with get, set
Public Property Mode As LiteralMode

속성 값

LiteralMode

LiteralMode 열거형 값 중 하나입니다. 기본값은 Transform입니다.

예외

ArgumentOutOfRangeException

지정한 형식이 LiteralMode 열거형 값 중 하나가 아닌 경우

예제

다음 코드 예제에서는 설정 하는 방법에 설명 된 Literal 컨트롤의 Mode 속성입니다. 합니다 Mode 처음에 속성이 Encode 컨트롤에 선언적 구문으로 합니다. 사용자가 설정 하는 단추를 클릭할 수 페이지를 로드 한 후 합니다 Mode 속성을 PassThrough입니다. 이 인해 내용의 Text 다르게 렌더링 하는 속성입니다.

참고

다음 예제에서는 단일 파일 코드 모델을 사용하며 코드 숨김 파일에 직접 복사하는 경우 제대로 작동하지 않을 수 있습니다. 이 코드 예제에서는 확장명이.aspx는 빈 텍스트 파일에 복사 해야 합니다. Web Forms 코드 모델에 대한 자세한 내용은 ASP.NET Web Forms 페이지 코드 모델을 참조하세요.

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Literal.Mode Property Example</title>
<script runat="Server">
       
        Sub PassThroughButton_Click(ByVal sender As Object, ByVal e As EventArgs)
   
            Literal1.Mode = LiteralMode.PassThrough
            
            Label1.Text = "The contents of the Literal.Text property " + _
                          "passed through to the browser:"
           
        End Sub
     
   </script>
</head>
<body>
    <form id="Form1" runat="server">
        
        <h3>Literal.Mode Property Example</h3>        
                             
        <asp:Label ID="Label1"
            Text="The HTML-encoded contents of the Literal.Text property:"
            runat="server">     
        </asp:Label><br /><br />
        
        <asp:Literal ID="Literal1"
            Mode="Encode"
            Text= "<b>bold</b><br/><i>italic</i><br/>"          
            runat="server">
        </asp:Literal>
       
        <hr />
       
        <asp:Button ID="PassThroughButton"
            Text="Pass Through Mode"
            OnClick="PassThroughButton_Click"
            runat="server">
        </asp:Button>
         
    </form>
</body>
</html>

설명

속성을 Mode 사용하여 컨트롤의 Literal 내용을 렌더링하는 방법을 지정합니다. 이 속성은 LiteralMode 열거형의 값 중 하나로 설정됩니다. 다음 표에서 가능한 값을 나열합니다.

값 설명
PassThrough 컨트롤의 내용이 수정되지 않습니다.
Encode 컨트롤의 내용은 HTML로 인코딩된 문자열로 변환됩니다.
Transform 지원되지 않는 태그 언어 요소는 컨트롤의 내용에서 제거됩니다. Literal HTML 또는 XHTML을 지원하는 브라우저에서 컨트롤을 렌더링하는 경우 컨트롤의 내용이 수정되지 않습니다.

지정 하는 경우 PassThrough를의 전체 내용을 Text 속성 수정 하지 않고 디바이스 또는 브라우저에 전달 됩니다. 예를 들어 경우는 Text 의 속성을 Literal 컨트롤에 포함는 <hr> 태그에 전송 된 모든 디바이스 및 브라우저 여부 지원 되는지 여부를 합니다.

지정 하는 경우 Encode에 대 한 콘텐츠를 Text 속성 렌더링 되기 전에 HTML로 인코딩된 문자열로 변환 됩니다. 예를 들어, 경우는 Text 의 속성을 Literal 컨트롤에 포함는 <hr> 로 변환 됩니다 태그를 &lt;Hr&gt; 디바이스 또는 브라우저에 전송 합니다.

지정 하는 경우 Transform의 렌더링 동작을 Text 속성 렌더링할 태그의 유형에 따라 다릅니다. 경우는 Literal 디바이스나 HTML 이나 XHTML을 지 원하는 브라우저에 렌더링 되는지 지정 Transform 지정 하는 것 같은 동작이 생성 PassThrough합니다. 모든 태그 및에 대 한 요소는 Text 속성 고 요청한 브라우저에 렌더링 됩니다.

Literal 컨트롤이 HTML 또는 XHTML 이외의 태그 언어(예: WML 또는 cHTML)에 대해 렌더링되는 경우 이 값을 사용하여 Transform 지원되지 않는 태그 요소를 제거할 수 있습니다. 이 경우 대상 태그 언어에서 지원되지 않는 속성의 Text 태그 언어 요소는 컨트롤에 대해 렌더링되지 않습니다. 예를 들어 경우는 Text 의 속성을 Literal 컨트롤에 포함 되어는 <hr> 태그, WML 디바이스에 콘텐츠 전송 되기 전에 제거 됩니다. 지원 되지 않는 태그를 콘텐츠에 있으면 태그만 제거 되 고 디바이스 또는 브라우저에 콘텐츠 전송 됩니다. 예를 들어 경우는 Text 속성 콘텐츠가 포함 <XYZ>Test</XYZ>, <XYZ> 및 </XYZ> 태그 제거 되 고 텍스트를 "테스트" 디바이스 또는 브라우저에 전송 됩니다.

적용 대상

추가 정보