Condividi tramite


Cenni preliminari sul controllo server Web Label

Aggiornamento: novembre 2007

Il controllo server Web Label consente di impostare la visualizzazione di testo in una pagina Web ASP.NET a livello di codice.

Vengono illustrati i seguenti argomenti:

  • Scenari

  • Funzionalità

  • Informazioni di supporto

  • Esempi di codice

  • Riferimento alle classi

Scenari

Viene in genere utilizzato quando si desidera modificare il testo nella pagina in fase di esecuzione, ad esempio in risposta al clic su un pulsante.

Torna all'inizio

Funzionalità

È possibile impostare il testo del controllo Label in fase di progettazione o in fase di esecuzione, all'interno di un programma. È inoltre possibile associare la proprietà Text del controllo Label a un'origine dati per visualizzare in una pagina le informazioni di un database.

Torna all'inizio

Informazioni di supporto

Il controllo Label può essere utilizzato come una didascalia attiva davanti a un controllo TextBox o a un altro controllo. In questo modo, gli utenti potranno premere un tasto di scelta per spostarsi sul controllo per il quale Label rappresenta la didascalia. Per informazioni dettagliate, vedere Procedura: utilizzare i controlli server Web Label come didascalie.

Il controllo Label consente di visualizzare un testo in una pagina Web ASP.NET. In alternativa a questo controllo è possibile utilizzare:

  • Markup HTML   Se si desidera visualizzare testo statico, è possibile utilizzare il linguaggio HTML senza ricorrere a un controllo Label. Utilizzare quest'ultimo solo se è necessario modificare il contenuto o altre caratteristiche del testo nel codice server.

  • Controllo Literal   Come il controllo Label, il controllo Literal consente di impostare la visualizzazione di testo nella pagina a livello di codice. Tuttavia, il controllo Literal non supporta né proprietà di stile, né temi o interfacce.

Utilizzo di controlli Label in controlli elenco

Il controllo Label viene spesso utilizzato nei controlli server Web elenco, ad esempio i controlli Repeater, DataList, GridView, DetailsView e FormView, per visualizzare informazioni di sola lettura da un database. In genere si aggiunge un controllo Label a un modello per uno di questi controlli, quindi si associa Label a un'origine dati. Per informazioni dettagliate sui modelli, vedere Modelli dei controlli server Web ASP.NET.

Protezione e controllo Label

È possibile impostare la proprietà Text del controllo Label su una stringa qualsiasi, incluse stringhe contenenti tag. In questo caso, Label interpreterà i tag. Se, ad esempio, si imposta la proprietà Text su <b>Test</b>, il controllo Label eseguirà il rendering della parola Test in grassetto.

Per evitare problemi di sicurezza, ad esempio il rischio di attacchi script injection, si sconsiglia di impostare la proprietà Text su una stringa contenente markup proveniente da un'origine non attendibile. Se l'origine della stringa utilizzata per la proprietà Text non è considerata attendibile, si consiglia di codificare la stringa. Per informazioni dettagliate, vedere Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTML.

Torna all'inizio

Esempi di codice

Procedura: aggiungere controlli server Web Label a una pagina Web Form (Visual Studio)

Procedura: utilizzare i controlli server Web Label come didascalie

Torna all'inizio

Riferimento alle classi

Nella tabella riportata di seguito sono elencate le classi correlate al controllo Label.

Membro

Descrizione

Label

Classe principale per il controllo.

Torna all'inizio

Vedere anche

Riferimenti

Cenni preliminari sul controllo server Web Literal