Cenni preliminari sul controllo server Web Literal
Aggiornamento: novembre 2007
È possibile utilizzare un controllo server Web Literal come contenitore per altre informazioni nella pagina.
Vengono illustrati i seguenti argomenti:
Scenari
Informazioni di supporto
Esempi di codice
Riferimento alle classi
Scenari
Il controllo Literal viene in genere utilizzato quando si aggiunge del contenuto alla pagina in modo dinamico.
Torna all'inizio
Informazioni di supporto
Il controllo Literal è una delle diverse opzioni disponibili per l'aggiunta di contenuto a una pagina. Nel caso di contenuto statico, è possibile aggiungere markup a una pagina direttamente come HTML, senza utilizzare un contenitore. Se invece si desidera aggiungere del contenuto in modo dinamico, occorre prima inserirlo in un contenitore. Tra i contenitori tipici sono inclusi i controlli Label, Literal, Panel e PlaceHolder.
La differenza tra il controllo Literal e il controllo Label sta nel fatto che il primo non aggiunge alcun elemento HTML al testo, mentre il secondo esegue il rendering di un elemento span. Di conseguenza, il controllo Literal non supporta alcun attributo di stile, inclusi gli attributi di posizione. Il controllo Literal consente tuttavia di specificare se il contenuto è codificato.
I controlli Panel e PlaceHolder sono rappresentati da elementi div, che creano blocchi discreti nella pagina, diversamente da Label e Literal, per i quali viene eseguito il rendering inline.
È in genere opportuno utilizzare un controllo Literal quando si desidera eseguire il rendering di testo e controlli direttamente in una pagina, senza markup aggiuntivo.
Codifica del contenuto nel controllo Literal
Il controllo Literal supporta la proprietà Mode, che specifica la modalità in cui deve essere gestito il markup che viene aggiunto al controllo. È possibile impostare la proprietà Mode sui seguenti valori:
Transform. L'eventuale markup aggiunto al controllo viene trasformato in base al protocollo del browser richiedente. Questa impostazione è utile quando si esegue il rendering del contenuto su dispositivi portatili che utilizzano un protocollo diverso da HTML.
PassThrough. L'eventuale markup aggiunto al controllo viene visualizzato così com'è nel browser.
Encode. L'eventuale markup aggiunto al controllo viene codificato tramite il metodo HtmlEncode, che converte la codifica HTML nella relativa rappresentazione di testo. Ad esempio, un tag <b> viene visualizzato come <b>. La codifica è utile quando si desidera che il browser visualizzi il markup anziché interpretarlo La codifica risulta utile anche per la sicurezza, alfine di impedire che nel browser venga eseguito markup dannoso. Inoltre è consigliata se si visualizzano stringhe provenienti da un'origine non attendibile. Per ulteriori informazioni, vedere Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTML.
Esempi di codice
Procedura: aggiungere controlli server Web Literal a una pagina Web Form (Visual Studio)
Riferimento alle classi
Nella tabella riportata di seguito sono elencate le classi correlate al controllo Literal.
Membro |
Descrizione |
|---|---|
Classe principale per il controllo. |
Torna all'inizio