Literal.Text Literal.Text Literal.Text Literal.Text Property

Определение

Получает или задает заголовок, отображаемый в элементе управления Literal.Gets or sets the caption displayed in the Literal control.

public:
 property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string Text { get; set; }
member this.Text : string with get, set
Public Property Text As String

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

Заголовок, отображаемый в элементе управления Literal.The caption displayed in the Literal control.

Реализации

Примеры

В следующем примере демонстрируется использование Text свойства для программного изменения заголовка, отображаемого Literal в элементе управления.The following example demonstrates how to use the Text property to programmatically change the caption displayed in the Literal control.

Примечание

В следующем примере используется модель кода с одним файлом, которая может работать неправильно при копировании непосредственно в файл кода программной части.The following example uses the single-file code model and might not work correctly if copied directly into a code-behind file. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением. aspx.This code example must be copied into an empty text file that has an .aspx extension. Дополнительные сведения о модели кода веб-форм см. в разделе модель кода страницы веб-форм ASP.NET.For more information about 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>Literal Example</title>
<script runat="server">

      void ButtonClick(Object sender, EventArgs e)
      {
         Literal1.Text="Welcome to ASP.NET!!";
      }

   </script>

</head>
<body>
   <form id="form1" runat="server">
      <h3>Literal Example</h3>

      <asp:Literal id="Literal1"
           Text="Hello World!!"
           runat="server"/>

      <br /><br />

      <asp:Button id="Button1"
           Text="Change Literal Text"
           OnClick="ButtonClick"
           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>Literal Example</title>
<script runat="server">

      Sub ButtonClick(sender As Object, e As EventArgs)
      
         Literal1.Text="Welcome to ASP.NET!!"
      
      End Sub

   </script>

</head>
<body>
   <form id="form1" runat="server">
      <h3>Literal Example</h3>

      <asp:Literal id="Literal1"
           Text="Hello World!!"
           runat="server"/>

      <br /><br />

      <asp:Button id="Button1"
           Text="Change Literal Text"
           OnClick="ButtonClick"
           runat="server"/>

   </form>
</body>
</html>

Комментарии

Используйте свойство, чтобы указать или определить заголовок, отображаемый Literal в элементе управления. TextUse the Text property to specify or determine the caption displayed in the Literal control. Это позволяет программно изменять заголовок во время выполнения.This allows you to programmatically change the caption at run time.

Заголовок размещается в формате HTML в зависимости от способа назначения значения этому свойству.The caption is HTML-decoded depending on how you assign a value to this property. Если значение присваивается через атрибут Literal элемента управления, то перед его отображением значение будет декодировано в формате HTML.If you assign a value through an attribute of the Literal control, the value is HTML decoded before it is displayed. Например, <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> отображается как "A B" в браузере.For example, <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> is rendered as "A B" on the browser. Однако если задать это свойство программно или путем помещения текста между открывающим и закрывающим тегами элемента управления, заголовок не будет декодирован в формате HTML.However, if you set this property programmatically or by placing the text between the opening and closing tags of the control, the caption is not HTML decoded. Например, <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> отображается как «A B».For example, <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> is rendered as "A B".

Внимание!

Этот элемент управления можно использовать для вывода вводимых пользователем данных, которые могут включать вредоносный клиентский скрипт.This control can be used to display user input, which might include malicious client script. Проверьте все данные, отправляемые клиентом для исполняемого скрипта, инструкций SQL или другого кода, прежде чем отображать его в приложении.Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET предоставляет функцию проверки входных запросов, которая блокирует скрипты и HTML-код при вводе данных пользователем.ASP.NET provides an input request validation feature to block script and HTML in user input. Также предоставляются проверочные элементы управления для оценки вводимых пользователем данных.Validation server controls are also provided to assess user input. Дополнительные сведения см. в разделе Проверка синтаксиса серверных элементов управления.For more information, see Validation Server Control Syntax.

Значение этого свойства, если оно задано, можно автоматически сохранить в файл ресурсов с помощью средства конструктора.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Дополнительные сведения см LocalizableAttribute . в статьях и Глобализация и локализация.For more information, see LocalizableAttribute and Globalization and Localization.

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

Дополнительно