Label.Text Proprietà

Definizione

Ottiene o imposta il contenuto del testo del controllo Label.

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

Valore della proprietà

Contenuto di testo del controllo. Il valore predefinito è Empty.

Implementazioni

Attributi

Esempio

Nell'esempio seguente viene illustrato come creare una nuova istanza del Label controllo e impostare la relativa Text proprietà.

Nota

L'esempio di codice seguente usa il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind. Questo esempio di codice deve essere copiato in un file di testo vuoto con un'estensione .aspx. Per altre informazioni sul modello di codice Web Forms, vedere ASP.NET modello di codice della pagina 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>

Commenti

Utilizzare la Text proprietà per specificare o determinare il contenuto di testo del Label controllo. Questa proprietà viene comunemente usata per personalizzare a livello di codice il testo visualizzato nel Label controllo.

La Text proprietà può includere HTML. In caso contrario, il codice HTML verrà passato invariato al browser, dove potrebbe essere interpretato come markup e non come testo. Se si vuole che il browser visualizzi il markup HTML come testo normale, è possibile usare il HtmlEncode metodo, come illustrato nell'esempio per la panoramica della classe. È anche possibile usare il Literal controllo anziché il Label controllo e impostare la Mode proprietà su Encode.

Nota

L'impostazione della Text proprietà cancella tutti gli altri controlli contenuti nel Label controllo.

Importante

Questo controllo può essere usato per visualizzare l'input utente, che è una potenziale minaccia di sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.

Il valore di questa proprietà, quando impostato, può essere salvato automaticamente in un file di risorse usando uno strumento di progettazione. Per altre informazioni, vedere LocalizableAttributee ASP.NET Globalizzazione e localizzazione.

Questa proprietà è la proprietà predefinita a cui un ControlParameter oggetto viene associato in fase di esecuzione. Per altre informazioni, vedere ControlValuePropertyAttribute, ControlParametere Uso di parametri con i controlli origine dati per il filtro.

Si applica a