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 的空白文字檔。 如需Web Form程式碼模型的詳細資訊，請參閱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 指派值，該值會在顯示之前先解碼。 例如， <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 和 全球化和當地語系化。

適用於

另請參閱