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 網頁代碼模型。
<%@ 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 屬性指派值，則會在顯示值之前先譯碼此值。 例如， <asp:Literal id="DisplayLiteral" Text="A B"/> 會在瀏覽器中轉譯為 “A B”。 不過，如果您以程式設計方式設定此屬性，或在控件的開頭和結尾標記之間放置文字，則標題不會譯碼 HTML。 例如， <asp:Literal id="DisplayLiteral"> A B </asp:Literal> 會轉譯為 “A B”。
警告
此控制項可用來顯示使用者輸入，其中可能包含惡意用戶端文本。 在應用程式中顯示可執行檔文本、SQL 語句或其他程式代碼之前，請先檢查從用戶端傳送的任何資訊。 ASP.NET 提供輸入要求驗證功能，以封鎖使用者輸入中的腳本和 HTML。 也會提供驗證伺服器控制件來評估使用者輸入。 如需詳細資訊，請參閱 驗證伺服器控件語法。
當設定時，此屬性的值可以使用設計工具自動儲存到資源檔。 如需詳細資訊，請參閱 LocalizableAttribute和全球化和當地語系化。
