Literal.Text 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

获取或设置在 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

属性值

String

在 Literal 控件中显示的标题。

实现

Text
属性
BindableAttribute

示例

以下示例演示如何使用 Text 属性以编程方式更改 控件中显示的 Literal 标题。

注意

以下示例使用单文件代码模型，如果直接复制到代码隐藏文件中，可能无法正常工作。 此代码示例必须复制到扩展名为 .aspx 的空文本文件中。 有关Web Forms代码模型的详细信息，请参阅 ASP.NET Web Forms页代码模型。


<%@ 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&nbsp;B"/> 在浏览器中呈现为“A B”。 但是，如果以编程方式或通过在控件的开始标记和结束标记之间放置文本来设置此属性，则不会对标题进行 HTML 解码。 例如， <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> 呈现为“A B”。

注意

此控件可用于显示用户输入，其中可能包括恶意客户端脚本。 在应用程序中显示之前，请检查从客户端发送的任何信息，以获取可执行脚本、SQL 语句或其他代码。 ASP.NET 提供了输入请求验证功能，用于阻止用户输入中的脚本和 HTML。 还提供了验证服务器控件来评估用户输入。 有关详细信息，请参阅 验证服务器控件语法。

设置此属性的值后，可以使用设计器工具自动保存到资源文件。 有关详细信息，请参阅 LocalizableAttribute 和 全球化和本地化。

适用于

另请参阅