共用方式為

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 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&nbsp;B"/> 會在瀏覽器中轉譯為 “A B”。 不過，如果您以程式設計方式設定此屬性，或在控件的開頭和結尾標記之間放置文字，則標題不會譯碼 HTML。 例如， <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> 會轉譯為 “A B”。

警告

此控制項可用來顯示使用者輸入，其中可能包含惡意用戶端文本。 在應用程式中顯示可執行檔文本、SQL 語句或其他程式代碼之前，請先檢查從用戶端傳送的任何資訊。 ASP.NET 提供輸入要求驗證功能，以封鎖使用者輸入中的腳本和 HTML。 也會提供驗證伺服器控制件來評估使用者輸入。 如需詳細資訊，請參閱 驗證伺服器控件語法。

當設定時，此屬性的值可以使用設計工具自動儲存到資源檔。 如需詳細資訊，請參閱 LocalizableAttribute和全球化和當地語系化。

適用於

另請參閱