Label.Text Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à

String

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

Implementazioni

Text

Attributi: BindableAttribute PersistenceModeAttribute

Esempio

Nell'esempio seguente viene illustrato come creare una nuova istanza del Label controllo e impostarne la 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 estensione aspx. Per altre informazioni sul modello di codice Web Forms, vedere Web Forms ASP.NET 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 di testo del Label controllo. Questa proprietà viene comunemente utilizzata per personalizzare a livello di codice il testo visualizzato nel Label controllo .

La Text proprietà può includere HTML. In caso affermativo, il codice HTML verrà passato invariato al browser, dove può 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 utilizzare 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 dell'utente, ovvero una potenziale minaccia per la 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à, se impostato, può essere salvato automaticamente in un file di risorse usando uno strumento di progettazione. Per altre informazioni, vedere LocalizableAttribute e ASP.NET Globalizzazione e localizzazione.

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

Si applica a