Label (Clase)
Actualización: noviembre 2007
Representa un control de etiqueta que muestra texto en una página Web.
Ensamblado: System.Web (en System.Web.dll)
[ControlValuePropertyAttribute("Text")] [AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)] [AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)] public class Label : WebControl, ITextControl
/** @attribute ControlValuePropertyAttribute("Text") */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class Label extends WebControl implements ITextControl
public class Label extends WebControl implements ITextControl
<asp:Label />
Utilice el control Label para mostrar texto en una ubicación establecida de la página. A diferencia del texto estático, se puede personalizar el texto que se muestra mediante la propiedad Text.
También es posible utilizar los controles Literal y PlaceHolder para mostrar texto en la página de formularios Web Forms. Sin embargo, al contrario de lo que ocurre con el control Label, estos controles no representan etiquetas adicionales.
 Nota de seguridad: |
|---|
Este control se puede utilizar para mostrar datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos. |
Accesibilidad
Es posible que el marcado que se representa de manera predeterminada para este control no respete los estándares de accesibilidad enunciados en las directrices prioritarias de WCAG (Instrucciones de accesibilidad a contenido Web 1.0). Para obtener detalles sobre accesibilidad compatible con este control, vea Controles y accesibilidad en ASP.NET.
En el ejemplo siguiente se muestra cómo crear un control Label en una página Web.
| Nota: |
|---|
El siguiente ejemplo de código utiliza el modelo de código de un solo archivo y puede que no funcione correctamente si se copia directamente en un archivo de código subyacente. Se debe copiar este código de ejemplo en un archivo de texto vacío con una extensión .aspx. Para obtener más información sobre el modelo de código de página Web de ASP.NET, vea Modelo de código de las páginas web ASP.NET. |
| Nota de seguridad: |
|---|
Este ejemplo tiene un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos. |
<%@ 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>Label Example</title> <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>
- AspNetHostingPermission
para trabajar en un entorno hospedado. Valor de la petición: LinkDemand; valor del permiso: Minimal.
- AspNetHostingPermission
para trabajar en un entorno hospedado. Valor de la petición: InheritanceDemand; valor del permiso: Minimal.
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Label
System.Web.UI.WebControls.BaseValidator
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
