通过

Literal 类

  • 项目

在网页上保留显示静态文本的位置。

**命名空间:**System.Web.UI.WebControls
**程序集:**System.Web（在 system.web.dll 中）

语法

声明
Public Class Literal
    Inherits Control
    Implements ITextControl
用法
Dim instance As Literal

public class Literal : Control, ITextControl

public ref class Literal : public Control, ITextControl

public class Literal extends Control implements ITextControl

public class Literal extends Control implements ITextControl

备注

使用 System.Web.UI.WebControls.Literal 控件在网页上保留显示文本的位置。Literal 控件与 Label 控件类似，但 Literal 控件不允许对所显示的文本应用样式。可以通过设置 Text 属性，以编程方式控制在控件中显示的文本。

警告

此控件可用来显示用户输入，而该输入可能包含恶意的客户端脚本。在应用程序中显示从客户端发送来的任何信息之前，请检查它们是否包含可执行脚本、SQL 语句或其他代码。ASP.NET 提供输入请求验证功能以阻止用户输入中的脚本和 HTML。还提供验证服务器控件以判断用户输入。有关更多信息，请参见 保证标准控件的安全、如何：通过对字符串应用 HTML 编码在 Web 应用程序中防止脚本侵入 和 在 ASP.NET 网页中验证用户输入。

主题 位置
演练：到自定义业务对象的数据绑定 在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建和使用 ASP.NET 母版页 在 Visual Studio 中构建 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 Literal Web 服务器控件 (Visual Studio) 在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建和使用 ASP.NET 母版页 使用 Visual Web Developer 生成应用程序
如何：向 Web 窗体页添加 Literal Web 服务器控件 (Visual Studio) 在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：以编程方式向 ASP.NET 网页添加控件 在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Table Web 服务器控件动态添加行和单元格 在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：到自定义业务对象的数据绑定 在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 Literal Web 服务器控件 (Visual Studio) 在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：以编程方式向 ASP.NET 网页添加控件 在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Table Web 服务器控件动态添加行和单元格 在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：到自定义业务对象的数据绑定 在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：以编程方式向 ASP.NET 网页添加控件 生成 ASP .NET Web 应用程序
如何：向 Table Web 服务器控件动态添加行和单元格 生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 PlaceHolder Web 服务器控件 生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 Literal Web 服务器控件 生成 ASP .NET Web 应用程序

示例

下面的示例说明如何使用 Literal 控件显示静态文本。

提示

以下代码示例使用单文件代码模型，当它直接复制到代码隐藏文件时可能不能正常工作。此代码示例必须被复制到具有 .aspx 扩展名的空文本文件中。有关 Web 窗体代码模型的更多信息，请参见 ASP.NET 网页代码模型。

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

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

   </script>

</head>
<body>
   <form 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" %>

<html>
<head>

   <script runat="server">

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

   </script>

</head>
<body>
   <form 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>

.NET Framework 安全性

继承层次结构

System.Object
   System.Web.UI.Control
    System.Web.UI.WebControls.Literal
       System.Web.UI.WebControls.Localize

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

Literal 成员
System.Web.UI.WebControls 命名空间
Label 类
Text

其他资源

Literal Web 服务器控件
保证标准控件的安全
如何：通过对字符串应用 HTML 编码在 Web 应用程序中防止脚本侵入
在 ASP.NET 网页中验证用户输入