Label.Text Label.Text Label.Text Label.Text Property

定义

获取或设置 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

属性值

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

实现

示例

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

备注

下面的代码示例使用单文件代码模型,如果直接复制到代码隐藏文件中,则可能无法正常工作。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>
   

注解

使用属性来指定或确定Label控件的文本内容。 TextUse 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.

备注

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

重要

此控件可用于显示用户输入,这是一个潜在的安全威胁。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. 有关详细信息,请LocalizableAttribute参阅和ASP.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. 有关详细信息,请ControlValuePropertyAttribute参阅ControlParameter、和对数据源控件使用参数进行筛选For more information, see ControlValuePropertyAttribute, ControlParameter, and Using Parameters with Data Source Controls for Filtering.

适用于