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

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

String

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

Реализации

Атрибуты

Примеры

В следующем примере показано, как создать новый экземпляр Label элемента управления и задать его Text свойство.

Примечание

В следующем примере кода используется модель кода с одним файлом, и она может работать неправильно, если копировать их непосредственно в файл кода программной части. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением. aspx. дополнительные сведения о модели кода веб-формы см. в разделе модель кода ASP.NET Web Forms Page.

<%@ 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 и Использование параметров с элементами управления источниками данных для фильтрации.

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