Compartir vía

Label.Text Propiedad

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el contenido de texto del Label control.

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)]
public virtual string Text { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)>]
member this.Text : string with get, set
Public Overridable Property Text As String

Valor de propiedad

String

Contenido de texto del control. El valor predeterminado es Empty.

Implementaciones

Text
Atributos
BindableAttribute PersistenceModeAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo crear una nueva instancia del Label control y establecer su Text propiedad.

Nota:

En el ejemplo de código siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío que tenga una extensión .aspx. Para obtener más información sobre el modelo de código de Formularios Web Forms, consulte ASP.NET modelo de código de página de formularios 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>Label Example</title>
<script language="C#" runat="server">
         void Button1_Click(Object Sender, EventArgs e) {
            Label l2 = new Label();
            l2.Text = "This is a new Label";
            l2.BorderStyle = BorderStyle.Solid;    
            Page.Controls.Add(l2);
         }
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" 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>Label Example</title>
<script language="VB" runat="server">
         Sub Button1_Click(Sender As Object, e As EventArgs)
            Dim l2 As New Label()
            l2.Text = "This is a new Label"
            l2.BorderStyle = BorderStyle.Solid
            Page.Controls.Add(l2)
         End Sub
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" Runat="server"/>
 
     </form>
 </body>
 </html>

Comentarios

Utilice la Text propiedad para especificar o determinar el contenido de texto del Label control. Esta propiedad se usa normalmente para personalizar mediante programación el texto que se muestra en el Label control .

La Text propiedad puede incluir HTML. Si es así, el código HTML se pasará sin cambios al explorador, donde se puede interpretar como marcado y no como texto. Si desea que el explorador muestre el marcado HTML como texto sin formato, puede usar el HtmlEncode método , como se muestra en el ejemplo de la información general de la clase. También puede usar el Literal control en lugar del Label control y establecer la Mode propiedad Encodeen .

Nota:

Al establecer la Text propiedad se borrarán los demás controles contenidos en el Label control.

Importante

Este control se puede usar para mostrar la entrada del usuario, que es una posible amenaza de seguridad. De forma predeterminada, ASP.NET páginas web validan que la entrada del usuario no incluye elementos HTML ni de script. Para obtener más información, consulte Información general sobre vulnerabilidades de seguridad de script.

El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador. Para obtener más información, consulte LocalizableAttribute y ASP.NET Globalización y localización.

Esta propiedad es la propiedad predeterminada a la que un ControlParameter objeto se enlaza en tiempo de ejecución. Para obtener más información, vea ControlValuePropertyAttribute, ControlParametery Using Parameters with Data Source Controls for Filtering (Usar parámetros con controles de origen de datos para filtrar).

Se aplica a