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 的空白文字檔中。 如需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>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 控制項，而不是 Label 控制項，並將 屬性設定 Mode 為 Encode 。

注意

Text設定 屬性會清除 控制項中包含的 Label 任何其他控制項。

重要

此控制項可用來顯示使用者輸入，這是潛在的安全性威脅。 根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊，請參閱 Script Exploits Overview (指令碼攻擊概觀)。

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

這個屬性是物件在執行時間系結至的預設屬性 ControlParameter 。 如需詳細資訊，請參閱 ControlValuePropertyAttribute 、 ControlParameter 和 搭配資料來源控制項使用參數以進行篩選。

適用於