Literal.Text Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает заголовок, отображаемый в элементе Literal управления.
public:
property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Bindable(true)]
public string Text { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, setPublic Property Text As StringЗначение свойства
Подпись, отображаемая в элементе Literal управления.
Реализации
- Атрибуты
Примеры
В следующем примере показано, как использовать Text свойство для программного изменения заголовка, отображаемого в элементе Literal управления.
Замечание
В следующем примере используется модель кода с одним файлом и может не работать правильно, если она копируется непосредственно в файл программной части. Этот пример кода должен быть скопирован в пустой текстовый файл с расширением .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>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>
Комментарии
Text Используйте свойство, чтобы указать или определить подпись, отображаемую в элементе Literal управления. Это позволяет программно изменять заголовок во время выполнения.
Заголовок декодируется HTML в зависимости от способа назначения значения этому свойству. Если вы назначаете значение с помощью атрибута Literal элемента управления, оно декодируется HTML перед отображением. Например, <asp:Literal id="DisplayLiteral" Text="A B"/> отображается как "A B" в браузере. Однако если задать это свойство программным способом или поместить текст между открываемыми и закрываемыми тегами элемента управления, заголовок не декодируется HTML. Например, <asp:Literal id="DisplayLiteral"> A B </asp:Literal> отрисовывается как "A B".
Предостережение
Этот элемент управления можно использовать для отображения входных данных пользователей, которые могут включать вредоносный скрипт клиента. Проверьте все сведения, отправляемые клиентом для исполняемого скрипта, инструкций SQL или другого кода перед отображением в приложении. ASP.NET предоставляет функцию проверки входных запросов для блокировки скрипта и HTML в входных данных пользователя. Серверные элементы управления проверки также предоставляются для оценки входных данных пользователей. Дополнительные сведения см. в разделе "Синтаксис управления сервером проверки".
Значение этого свойства, если задано, можно автоматически сохранить в файл ресурсов с помощью средства конструктора. Дополнительные сведения см. в статье LocalizableAttribute и глобализации и локализации.
