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, set
Public 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и Глобализация и локализация.