LiteralMode 열거형
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Literal 컨트롤의 내용을 렌더링하는 방법을 지정합니다.
public enum class LiteralModepublic enum LiteralModetype LiteralMode = Public Enum LiteralMode- 상속
필드
| Encode | 2 | 리터럴 컨트롤의 내용이 HTML로 인코딩됩니다. |
| PassThrough | 1 | 리터럴 컨트롤의 내용을 수정할 수 없습니다. |
| Transform | 0 | 리터럴 컨트롤의 지원되지 않는 태그 언어 요소가 제거됩니다. 리터럴 컨트롤이 HTML이나 XHTML을 지원하는 브라우저에서 렌더링되면 컨트롤의 내용이 수정되지 않습니다. |
예제
다음 예제에서는 설정 하는 방법에 설명 합니다 Literal.Mode 속성입니다. 처음에는 컨트롤에 대한 선언적 구문으로 설정 Encode 됩니다. 사용자가 설정 하는 단추를 클릭할 수 페이지를 로드 한 후 합니다 Mode 속성을 PassThrough입니다. 이 인해 내용의 Literal.Text 다르게 렌더링 하는 속성입니다.
<%@ 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>
설명
합니다 LiteralMode 열거 하는 방법에 대해 지정할 수 있는 모드를 나타냅니다의 콘텐츠는 Literal 컨트롤이 렌더링 되는 합니다. 이 속성은 Literal.Mode 이러한 열거형 값을 사용하여 속성 내용의 동작을 Literal.Text 설정합니다.
지정 하는 경우 PassThrough를의 전체 내용을 Literal.Text 속성 수정 하지 않고 브라우저 또는 디바이스에 전달 됩니다. 예를 들어 속성에 Literal.Text 태그가 <hr> 포함된 경우 지원되는지 여부에 관계없이 모든 디바이스 및 브라우저로 전송됩니다.
지정 하는 경우 Encode에 대 한 콘텐츠를 Text 속성 렌더링 되기 전에 HTML로 인코딩된 문자열로 변환 됩니다. 예를 들어 속성에 Literal.Text 태그가 <hr> 포함되어 있으면 해당 속성이 디바이스 또는 브라우저로 <hr> 변환되어 전송됩니다.
지정 하는 경우 Transform의 렌더링 동작을 Literal.Text 속성 렌더링할 태그의 유형에 따라 다릅니다. 경우는 Literal 디바이스나 HTML 이나 XHTML을 지 원하는 브라우저에 렌더링 되는지 지정 Transform 지정 하는 것 같은 동작이 생성 PassThrough합니다. 모든 태그 및에 대 한 요소는 Literal.Text 속성 고 요청한 브라우저에 렌더링 됩니다.
Literal 컨트롤이 HTML 또는 XHTML 이외의 태그 언어(예: WML 또는 cHTML)에 대해 렌더링되는 경우 이 값을 사용하여 Transform 지원되지 않는 태그 요소를 제거할 수 있습니다. 이 경우의 태그 언어 요소는 Literal.Text 대상된 태그 언어에서 지원 되지 않는 속성은 컨트롤의 렌더링 되지 않습니다. 예를 들어 속성에 Literal.Text 태그가 <hr> 포함된 경우 콘텐츠가 WML 디바이스로 전송되기 전에 태그가 제거됩니다. 지원 되지 않는 태그를 콘텐츠에 있으면 태그만 제거 되 고 디바이스 또는 브라우저에 콘텐츠 전송 됩니다. 예를 들어 경우는 Literal.Text 속성 내용이 <XYZ>Test</XYZ>, <XYZ> 및 </XYZ> 태그 텍스트를 하는 동안 제거 됩니다 Test 디바이스 또는 브라우저에 전송 됩니다.