Label.Text Label.Text Label.Text Label.Text Property

Definición

Obtiene o establece el contenido de texto del control Label.Gets or sets the text content of the 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; }
member this.Text : string with get, set
Public Overridable Property Text As String

Valor de propiedad

Contenido de texto del control.The text content of the control. El valor predeterminado es Empty.The default value is Empty.

Implementaciones

Ejemplos

En el ejemplo siguiente se muestra cómo crear una nueva instancia del Label control y establecer su Text propiedad.The following example demonstrates how to create a new instance of the Label control and set its Text property.

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.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Este ejemplo de código se debe copiar en un archivo de texto vacío que tenga una extensión. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Para obtener más información sobre el modelo de código de formularios Web Forms, vea modelo de código de la Página de formularios web forms ASP.net.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

<%@ 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 Label de texto del control.Use the Text property to specify or determine the text content of the Label control. Esta propiedad se utiliza normalmente para personalizar mediante programación el texto que se muestra en el Label control.This property is commonly used to programmatically customize the text that is displayed in the Label control.

La Text propiedad puede incluir HTML.The Text property can include HTML. Si es así, el código HTML se pasará sin cambiar al explorador, donde se podría interpretar como marcado y no como texto.If it does, the HTML will be passed unchanged to the browser, where is might be interpreted as markup and not as text. Si desea que el explorador muestre el marcado HTML como texto sin formato, puede utilizar el HtmlEncode método, como se muestra en el ejemplo de la información general de la clase.If you want the browser to display HTML markup as plain text, you can use the HtmlEncode method, as shown in the example for the class overview. Literal También puede usar el control en lugar Label del control y establecer la Mode propiedad en Encode.You can also use the Literal control instead of the Label control, and set the Mode property to Encode.

Nota

Si se Text establece la propiedad, se borrarán todos los Label demás controles contenidos en el control.Setting the Text property will clear any other controls contained in the Label control.

Importante

Este control se puede usar para mostrar los datos proporcionados por el usuario, que es una posible amenaza de seguridad.This control can be used to display user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.For more information, see Script Exploits Overview.

El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Para obtener más información, LocalizableAttribute consulte y globalización y localización de ASP.net.For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.

Esta propiedad es la propiedad predeterminada a la ControlParameter que se enlaza un objeto en tiempo de ejecución.This property is the default property that a ControlParameter object binds to at run time. Para obtener más información, ControlValuePropertyAttributevea ControlParameter, y usar parámetros con controles de origen de datos para el filtrado.For more information, see ControlValuePropertyAttribute, ControlParameter, and Using Parameters with Data Source Controls for Filtering.

Se aplica a