Literal.Text 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Literal 컨트롤에 표시된 텍스트 캡션을 가져오거나 설정합니다.
public:
property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Bindable(true)]
public string Text { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, setPublic Property Text As String속성 값
Literal 컨트롤에 표시된 텍스트 캡션입니다.
구현
- 특성
예제
다음 예제에서는 컨트롤에 Text 표시 된 Literal 캡션을 프로그래밍 방식으로 변경 하는 속성을 사용 하는 방법을 보여 줍니다.
참고
다음 예제에서는 단일 파일 코드 모델을 사용하며 코드 숨김 파일에 직접 복사하는 경우 제대로 작동하지 않을 수 있습니다. 이 코드 예제에서는 확장명이.aspx는 빈 텍스트 파일에 복사 해야 합니다. Web Forms 코드 모델에 대한 자세한 내용은 ASP.NET Web Forms 페이지 코드 모델을 참조하세요.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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 Example</title>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Literal1.Text="Welcome to ASP.NET!!";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Literal Example</h3>
<asp:Literal id="Literal1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Literal Text"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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 Example</title>
<script runat="server">
Sub ButtonClick(sender As Object, e As EventArgs)
Literal1.Text="Welcome to ASP.NET!!"
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Literal Example</h3>
<asp:Literal id="Literal1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Literal Text"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
설명
Text 속성을 사용하여 컨트롤에 표시되는 Literal 캡션을 지정하거나 결정합니다. 이렇게 하면 런타임에 캡션을 프로그래밍 방식으로 변경할 수 있습니다.
캡션은 이 속성에 값을 할당하는 방법에 따라 HTML 디코딩됩니다. 컨트롤의 Literal 특성을 통해 값을 할당하면 값이 표시되기 전에 HTML 디코딩됩니다. 예를 들어 브라우저에서 <asp:Literal id="DisplayLiteral" Text="A B"/> "A B"로 렌더링됩니다. 그러나 이 속성을 프로그래밍 방식으로 설정하거나 컨트롤의 여는 태그와 닫는 태그 사이에 텍스트를 배치하면 캡션이 HTML 디코딩되지 않습니다. 예를 들어 <asp:Literal id="DisplayLiteral"> A B </asp:Literal> "AB "로 렌더링됩니다.
주의
악성 클라이언트 스크립트 포함 될 수 있는 사용자 입력을 표시 하려면이 제어를 사용할 수 있습니다. 애플리케이션에서 표시 하기 전에 실행 스크립트, SQL 문 또는 다른 코드에 대 한 클라이언트에서 전송 되는 모든 정보를 확인 합니다. ASP.NET에서는 사용자 입력에서 차단 스크립트를 HTML 입력된 요청 유효성 검사 기능을 제공 합니다. 유효성 검사 서버 컨트롤이 사용자 입력을 평가 하기 위해 제공 됩니다. 자세한 내용은 유효성 검사 서버 컨트롤 구문합니다.
이 속성의 값으로 설정 된 경우 디자이너 도구를 사용 하 여 리소스 파일에 자동으로 저장 될 수 있습니다. 자세한 내용은 LocalizableAttribute 하 고 전역화 및 지역화합니다.