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

Definizione

Ottiene o imposta il contenuto del testo del controllo 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

Valore della proprietà

Contenuto di testo del controllo.The text content of the control. Il valore predefinito è Empty.The default value is Empty.

Implementazioni

Esempi

Nell'esempio seguente viene illustrato come creare una nuova istanza del Label controllo e impostarne la Text proprietà.The following example demonstrates how to create a new instance of the Label control and set its Text property.

Nota

Nell'esempio di codice seguente viene utilizzato il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Questo esempio di codice deve essere copiato in un file di testo vuoto con estensione aspx.This code sample must be copied into an empty text file that has an .aspx extension. Per ulteriori informazioni sul modello di codice Web Form, vedere il modello di codice della pagina Web form 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>
   

Commenti

Utilizzare la Text proprietà per specificare o determinare il contenuto Label di testo del controllo.Use the Text property to specify or determine the text content of the Label control. Questa proprietà viene comunemente utilizzata per personalizzare a livello di codice il testo visualizzato nel Label controllo.This property is commonly used to programmatically customize the text that is displayed in the Label control.

La Text proprietà può includere HTML.The Text property can include HTML. In caso contrario, il codice HTML viene passato senza modifiche al browser, dove è potrebbe essere interpretato come markup e non come testo.If it does, the HTML will be passed unchanged to the browser, where is might be interpreted as markup and not as text. Se si vuole che il browser visualizzi il markup HTML come testo normale, è possibile HtmlEncode usare il metodo, come illustrato nell'esempio relativo alla panoramica della classe.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. È anche possibile usare il Literal controllo anziché il Label controllo e impostare la Mode proprietà su Encode.You can also use the Literal control instead of the Label control, and set the Mode property to Encode.

Nota

Impostando Text la proprietà si cancelleranno tutti gli altri controlli Label contenuti nel controllo.Setting the Text property will clear any other controls contained in the Label control.

Importante

Questo controllo può essere usato per visualizzare l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza.This control can be used to display user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.For more information, see Script Exploits Overview.

Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse tramite uno strumento di progettazione.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Per ulteriori informazioni, vedere LocalizableAttribute e ASP.NET globalizzazione e localizzazione.For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.

Questa proprietà è la proprietà predefinita a cui ControlParameter viene associato un oggetto in fase di esecuzione.This property is the default property that a ControlParameter object binds to at run time. Per ulteriori informazioni, vedere ControlValuePropertyAttribute, ControlParametere utilizzo di parametri con i controlli origine dati per l'applicazione di filtri.For more information, see ControlValuePropertyAttribute, ControlParameter, and Using Parameters with Data Source Controls for Filtering.

Si applica a