Декларативный синтаксис серверного веб-элемента управления Literal

Статья
11/16/2008

Обновлен: Ноябрь 2007

Отображает на странице статическое содержимое, управляемое программно.

<asp:Literal
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    Mode="Transform|PassThrough|Encode"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Text="string"
    Visible="True|False"
/>

Заметки

Элемент управления Literal предназначен для отображения статического текста на странице Web Forms. В отличие от элемента управления Label,Literalне позволяет применить стили к содержимому.

Примечание.
Перед отображением в элементе управления Literal текст не преобразуется в формат HTML. Это позволяет внедрить текст сценария в теги HTML, содержащиеся в тексте. Если значения элемента управления вводятся пользователем, следует проверять их на допустимость, чтобы избежать снижения уровня безопасности.

Перед отображением в элементе управления Literal текст не преобразуется в формат HTML. Это позволяет внедрить текст сценария в теги HTML, содержащиеся в тексте. Если значения элемента управления вводятся пользователем, следует проверять их на допустимость, чтобы избежать снижения уровня безопасности.

Пример

В следующем примере демонстрируется использование свойства Literal для отображения статического текста.

<%@ 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>

<%@ 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>

См. также

Ссылки

Literal

Другие ресурсы

Синтаксис серверного веб-элемента управления

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