Literal.Text 屬性

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定控制面板中 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, set
Public Property Text As String

屬性值

String

標題顯示在控制面板 Literal 上。

實作

Text
屬性
BindableAttribute

範例

以下範例示範如何利用該 Text 屬性程式化更改控制項中顯示 Literal 的說明文字。

備註

以下範例使用單一檔案程式碼模型，若直接複製到程式碼背後檔案，可能無法正常運作。 此程式碼範例必須複製到一個副檔名為 .aspx 的空文字檔中。 欲了解更多關於網頁表單程式碼模型的資訊，請參見 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 屬性指派一個值，該值會在顯示前先被 HTML 解碼。 例如， <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> 在瀏覽器中會被呈現為「A B」。 然而，如果你以程式方式設定此屬性，或是將文字置於控制項的開閉標籤之間，說明文字並非 HTML 解碼。 例如， <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> 會被呈現為「A B」。

謹慎

此控制項可用來顯示使用者輸入，可能包含惡意用戶端腳本。 在顯示到應用程式前，請檢查客戶端傳送的任何可執行腳本、SQL 語句或其他程式碼資訊。 ASP.NET 提供輸入請求驗證功能，以阻擋使用者輸入中的腳本與 HTML。 同時也提供驗證伺服器控制以評估使用者輸入。 欲了解更多資訊，請參閱 驗證伺服器控制語法。

設定後，該屬性的值可透過設計工具自動儲存到資源檔案中。 欲了解更多資訊，請參閱LocalizableAttribute全球化與在地化。

適用於

另請參閱