Поделиться через

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

Замечание

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

Это важно

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

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

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

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