Label 类

项目
08/17/2007

表示在网页上显示文本的标签控件。

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

语法

声明
<ControlValuePropertyAttribute("Text")> _
Public Class Label
    Inherits WebControl
    Implements ITextControl
用法
Dim instance As Label

[ControlValuePropertyAttribute("Text")] 
public class Label : WebControl, ITextControl

[ControlValuePropertyAttribute(L"Text")] 
public ref class Label : public WebControl, ITextControl

/** @attribute ControlValuePropertyAttribute("Text") */ 
public class Label extends WebControl implements ITextControl

ControlValuePropertyAttribute("Text") 
public class Label extends WebControl implements ITextControl

备注

使用 Label 控件在网页的设置位置上显示文本。不像静态文本，可以通过 Text 属性自定义显示文本。

也可以使用 Literal 和 PlaceHolder 控件在 Web 窗体页上显示文本。但与 Label 控件不同的是，这些控件不会呈现任何附加标记。

警告

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

辅助功能

默认情况下为此控件呈现的标记可能不符合 Web 内容辅助功能准则 1.0 (WCAG) 中优先级为 1 的准则等辅助功能标准。有关此控件的辅助功能支持的详细信息，请参见 ASP.NET 控件和辅助功能。

主题	位置
演练：为 ASP.NET Web 服务器控件创建基本控件设计器	创作 ASP.NET 控件
演练：创建具有辅助功能的 Web 应用程序	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：到自定义业务对象的数据绑定	在 Visual Studio 中构建 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 Label Web 服务器控件 (Visual Studio)	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中使用级联样式表样式	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：验证 Web 窗体页中的用户输入	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建和使用 ASP.NET 母版页	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建基本网页	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中通过代码分离创建基本网页	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Studio 中使用主题自定义网站	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建和使用 ASP.NET 母版页	使用 Visual Web Developer 生成应用程序
演练：验证 Web 窗体页中的用户输入	使用 Visual Web Developer 生成应用程序
演练：在 Visual Web Developer 中通过代码分离创建基本网页	使用 Visual Web Developer 生成应用程序
演练：在 Visual Studio 中使用主题自定义网站	使用 Visual Web Developer 生成应用程序
演练：创建具有辅助功能的 Web 应用程序	使用 Visual Web Developer 生成应用程序
演练：为 Web 服务器控件创建基本控件设计器	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：在 DataList Web 服务器控件中动态创建模板	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：以编程方式向 ASP.NET 网页添加控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：在 Calendar Web 服务器控件中自定义个别日	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：将 Label Web 服务器控件用作标题	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：到自定义业务对象的数据绑定	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建基本网页	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 Label Web 服务器控件 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：为 Web 服务器控件创建基本控件设计器	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：在 DataList Web 服务器控件中动态创建模板	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：以编程方式向 ASP.NET 网页添加控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：在 Calendar Web 服务器控件中自定义个别日	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：将 Label Web 服务器控件用作标题	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：到自定义业务对象的数据绑定	在 Visual Studio 中生成 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建基本网页	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 Label Web 服务器控件 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：在 DataList Web 服务器控件中动态创建模板	生成 ASP .NET Web 应用程序
如何：以编程方式向 ASP.NET 网页添加控件	生成 ASP .NET Web 应用程序
如何：在 Calendar Web 服务器控件中自定义个别日	生成 ASP .NET Web 应用程序
如何：将 Label Web 服务器控件用作标题	生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加 Label Web 服务器控件	生成 ASP .NET Web 应用程序

示例

下面的示例说明如何在网页上创建 Label 控件。

提示

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

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

   <script language="VB" runat="server">

      Sub Button_Click(Sender As Object, e As EventArgs) 
         Label1.Text = Server.HtmlEncode(Text1.Text)
      End Sub

   </script>

</head>

<body>

   <form id="Form1" runat="server">

      <h3>Label Example</h3>

      <asp:Label id="Label1" 
                 Text="Label Control" 
                 runat="server"/>

      <p>
        
      <asp:TextBox id="Text1" 
           Text="Copy this text to the label"
           Width="200px"  
           runat="server" />

      <asp:Button id="Button1" 
           Text="Copy" 
           OnClick="Button_Click" 
           runat="server"/>
      </p>
   </form>

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>

   <script language="C#" runat="server">

      void Button_Click(Object Sender, EventArgs e) 
      {
         Label1.Text = Server.HtmlEncode(Text1.Text);
      }

   </script>

</head>

<body>

   <form id="Form1" runat="server">

      <h3>Label Example</h3>

      <asp:Label id="Label1" 
                 Text="Label Control" 
                 runat="server"/>

      <p>
        
      <asp:TextBox id="Text1" 
           Text="Copy this text to the label"
           Width="200px"  
           runat="server" />

      <asp:Button id="Button1" 
           Text="Copy" 
           OnClick="Button_Click" 
           runat="server"/>
      </p>

   </form>

</body>
</html>

.NET Framework 安全性

AspNetHostingPermission 用于在宿主环境中进行操作。要求值：LinkDemand；权限值：Minimal。
AspNetHostingPermission 用于在宿主环境中进行操作。要求值：InheritanceDemand；权限值：Minimal。

继承层次结构

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.Label
         System.Web.UI.WebControls.BaseValidator

线程安全

此类型的任何公共静态（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

请参见

参考

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

其他资源

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