Label.Text Свойство

Определение

Возвращает или задает текстовое содержимое элемента управления 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

Значение свойства

Текстовое содержимое элемента управления. Значение по умолчанию — Empty.

Реализации

Атрибуты

Примеры

В следующем примере показано, как создать новый экземпляр 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 элемент управления вместо Label элемента управления и присвоить свойству Mode значение Encode.

Примечание

Если задать свойство, Text все остальные элементы управления, содержащиеся в элементе управления, будут очищены Label .

Важно!

Этот элемент управления можно использовать для отображения введенных пользователем данных, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

Значение этого свойства можно автоматически сохранить в файле ресурсов с помощью средства конструктора. Дополнительные сведения см. в разделе LocalizableAttribute и ASP.NET глобализация и локализация.

Это свойство по умолчанию, к которому ControlParameter привязывается объект во время выполнения. Дополнительные сведения см. в разделах ControlValuePropertyAttribute, ControlParameterи Использование параметров с элементами управления источником данных для фильтрации.

Применяется к