Cenni preliminare sul controllo server Web Localize
Aggiornamento: novembre 2007
Il controllo server Web Localize consente di visualizzare un testo localizzato in una determinata area della pagina.
Vengono illustrati i seguenti argomenti:
Background
Esempi di codice
Riferimento alle classi
Risorse supplementari
Background
Il controllo Localize è identico al controllo server Web Literal ed è simile al controllo server Web Label. Sebbene mediante il controllo Label sia possibile applicare uno stile al testo visualizzato, il controllo Localize non effettua tale operazione. È possibile controllare a livello di codice il testo visualizzato nel controllo Localize impostando la proprietà Text, ereditata dal controllo Literal.
Codifica del contenuto
Il controllo Localize supporta la proprietà Mode, che specifica la modalità in cui deve essere gestito il codice che viene aggiunto al controllo. È possibile impostare la proprietà Mode sui seguenti valori:
Transform Il codice 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 Il codice aggiunto al controllo viene visualizzato così com'è nel browser.
Encode Il codice 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 codice anziché interpretarlo La codifica risulta utile anche per la sicurezza e per impedire che nel browser venga eseguito codice dannoso. È consigliata per la visualizzazione di 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.
Localizzazione del testo utilizzando le stringhe di risorsa
È possibile creare stringhe localizzate da visualizzare nella proprietà Text del controllo Localize utilizzando un'espressione esplicita o implicita come valore della proprietà. Le espressioni vengono valutate utilizzando stringhe che vengono dichiarate nei file di risorse (con estensione resx).
Creare i file con estensione resx in cartelle denominate App_GlobalResources e App_LocalResources nella radice dell'applicazione. Se occorre localizzare delle stringhe per più lingue, è possibile creare altri file .resx con informazioni relative alle impostazioni internazionali incluse nel nome file. La versione francese del file di risorse, ad esempio, potrebbe essere denominata ExampleLocalizedStrings.fr.resx.
Per ulteriori informazioni sulle espressioni, vedere Cenni preliminari sulle espressioni ASP.NET. Per informazioni sui file di risorse, vedere Localizzazione di pagine Web ASP.NET tramite risorse. Per un esempio di codice in cui vengono utilizzate espressioni regolari nel controllo Localize, vedere Sintassi dichiarativa per il controllo server Web Localize.
Torna all'inizio
Esempi di codice
Procedura: aggiungere controlli server Web Localize a pagine Web ASP.NET (Visual Studio)
Torna all'inizio
Riferimento alle classi
Nella tabella riportata di seguito sono elencate le classi correlate al controllo Localize.
Membro |
Descrizione |
|---|---|
Classe principale del controllo. |
Torna all'inizio
Vedere anche
Concetti
Risorse nelle applicazioni ASP.NET
Cenni preliminari sulle espressioni ASP.NET