共用方式為

Label.Text 屬性

定義

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

取得或設定控制項的 Label 文字內容。

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)]
public virtual string Text { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)>]
member this.Text : string with get, set
Public Overridable Property Text As String

屬性值

String

控制項的文字內容。 預設值為 Empty。

實作

Text
屬性
BindableAttribute PersistenceModeAttribute

範例

以下範例示範如何建立新的控制項實例 Label 並設定其 Text 屬性。

備註

以下程式碼範例採用單檔案程式碼模型，若直接複製到程式碼背後的檔案中，可能無法正常運作。 此程式碼範例必須複製到一個具有 .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>Label Example</title>
<script language="C#" runat="server">
         void Button1_Click(Object Sender, EventArgs e) {
            Label l2 = new Label();
            l2.Text = "This is a new Label";
            l2.BorderStyle = BorderStyle.Solid;    
            Page.Controls.Add(l2);
         }
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" 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>Label Example</title>
<script language="VB" runat="server">
         Sub Button1_Click(Sender As Object, e As EventArgs)
            Dim l2 As New Label()
            l2.Text = "This is a new Label"
            l2.BorderStyle = BorderStyle.Solid
            Page.Controls.Add(l2)
         End Sub
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" Runat="server"/>
 
     </form>
 </body>
 </html>

備註

使用該 Text 屬性來指定或決定控制項的 Label 文字內容。 此特性常用於程式化自訂控制項中顯示 Label 的文字。

該 Text 屬性可以包含 HTML。 如果有，HTML 會被不修改地傳送到瀏覽器，瀏覽器可能會被解讀為標記而非文字。 如果你想讓瀏覽器以純文字顯示 HTML 標記，可以使用 HtmlEncode 這個方法，如課程總覽範例所示。 你也可以用 Literal control 代替 Label control，並將屬性設 Mode 為 Encode。

備註

設定該 Text 屬性後，控制項中包含的其他控制 Label 項會被清除。

這很重要

此控制可用來顯示使用者輸入，這可能構成安全威脅。 預設情況下，ASP.NET 網頁會驗證使用者輸入中不包含腳本或 HTML 元素。 欲了解更多資訊，請參閱 腳本漏洞概述。

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

這個屬性是物件執行時綁定的預設屬性 ControlParameter 。 更多資訊請參閱 ControlValuePropertyAttribute、 ControlParameter，以及 「利用參數搭配資料來源控制進行篩選」。

適用於