Label.Text Property

Definition

获取或设置 Label 控件的文本内容。Gets or sets the text content of the Label control.

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; }
member this.Text : string with get, set
Public Overridable Property Text As String

Property Value

String

控件的文本内容。The text content of the control. 默认值是 EmptyThe default value is Empty.

Implements

Attributes

Examples

下面的示例演示如何创建 Label 控件的新实例并设置其 Text 属性。The following example demonstrates how to create a new instance of the Label control and set its Text property.

Note

下面的代码示例使用单文件代码模型,如果直接复制到代码隐藏文件中,则可能无法正常工作。The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. 必须将此代码示例复制到扩展名为 .aspx 的空文本文件中。This code sample must be copied into an empty text file that has an .aspx extension. 有关 Web 窗体代码模型的详细信息,请参阅ASP.NET Web 窗体页代码模型For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

<%@ 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>
   

Remarks

使用 Text 属性指定或确定 Label 控件的文本内容。Use the Text property to specify or determine the text content of the Label control. 此属性通常用于以编程方式自定义 Label 控件中显示的文本。This property is commonly used to programmatically customize the text that is displayed in the Label control.

Text 属性可以包含 HTML。The Text property can include HTML. 如果是这样,则在浏览器中不会以任何方式传递 HTML,其中,可以解释为标记而不是文本。If it does, the HTML will be passed unchanged to the browser, where is might be interpreted as markup and not as text. 如果希望浏览器以纯文本形式显示 HTML 标记,则可以使用 HtmlEncode 方法,如类概述的示例中所示。If you want the browser to display HTML markup as plain text, you can use the HtmlEncode method, as shown in the example for the class overview. 你还可以使用 Literal 控件而不是 Label 控件,并将 Mode 属性设置为 EncodeYou can also use the Literal control instead of the Label control, and set the Mode property to Encode.

Note

设置 Text 属性将清除 Label 控件中包含的任何其他控件。Setting the Text property will clear any other controls contained in the Label control.

Important

此控件可用于显示用户输入,这是一个潜在的安全威胁。This control can be used to display user input, which is a potential security threat. 默认情况下,ASP.NET 网页验证用户输入是否不包含脚本或 HTML 元素。By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 有关详细信息,请参阅脚本侵入概述For more information, see Script Exploits Overview.

设置此属性后,可以使用设计器工具自动将此属性的值保存到资源文件中。The value of this property, when set, can be saved automatically to a resource file by using a designer tool. 有关详细信息,请参阅 LocalizableAttributeASP.NET 全球化和本地化For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.

此属性是 ControlParameter 对象在运行时绑定到的默认属性。This property is the default property that a ControlParameter object binds to at run time. 有关详细信息,请参阅 ControlValuePropertyAttributeControlParameter和将参数用于用于筛选的数据源控件For more information, see ControlValuePropertyAttribute, ControlParameter, and Using Parameters with Data Source Controls for Filtering.

Applies to