Procedura: creare file di risorse per i siti Web ASP.NET (Visual Studio)

Articolo
10/22/2014

Aggiornamento: novembre 2007

Un file di risorse è un file XML contenente stringhe e altre risorse, ad esempio percorsi di file di immagini. In genere, i file di risorse vengono utilizzati per memorizzare le stringhe dell'interfaccia utente che devono essere tradotte in altre lingue. Ciò avviene perché è possibile creare un file di risorse separato per ogni lingua in cui tradurre la pagina Web.

I file di risorse globali sono disponibili per ogni pagina o componente del sito Web. I file di risorse locali vengono associati a pagine Web, controlli utente o pagine master singoli e contengono solo le risorse relative alla pagina in questione. Per ulteriori informazioni, vedere Cenni preliminari sulle risorse delle pagine Web ASP.NET.

In Visual Web Developer, è possibile utilizzare l'editor di risorse gestite per creare file di risorse globali o locali. Per i file di risorse locali, è anche possibile generare nella finestra di progettazione un file di risorse di base non specifiche di alcuna lingua direttamente da una pagina Web.

Creazione manuale di file di risorse

Per creare un file di risorse manualmente

Assicurarsi che nel sito Web ci sia una cartella nella quale memorizzare il file delle risorse eseguendo una delle seguenti operazioni:
- Se viene creato un file di risorse globali, è necessario che nell'applicazione esista una cartella denominata App_GlobalResources. Per creare la cartella, in Esplora soluzioni, fare clic con il pulsante destro del mouse sul nome del sito Web, scegliere Aggiungi cartella, quindi App_GlobalResources. Un'applicazione può contenere solo una cartella di questo tipo e questa deve risiedere nella radice dell'applicazione.
- Se si sta creando un file di risorse locali, è necessario che nell'applicazione esista una cartella denominata App_LocalResources. Per creare la cartella, in Esplora soluzioni, fare clic con il pulsante destro del mouse sul nome del sito Web, scegliere Aggiungi cartella, quindi fare clic su App_GlobalResources. Un'applicazione può contenere più cartelle di questo tipo e queste possono risiedere in qualsiasi livello dell'applicazione.

Per creare un file di risorse, fare clic con il pulsante destro del mouse sulla cartella App_GlobalResources o App_LocalResources, quindi scegliere Aggiungi nuovo elemento.

Nota:
I file di risorse globali devono risiedere nella cartelle App_GlobalResources. Se si prova a creare un file RESX al di fuori di questa cartella, Visual Web Developer richiede che venga creato nella cartella.

Nella finestra di dialogo Aggiungi nuovo elemento, in Modelli Visual Studio installati, scegliere File di risorse assembly.
Nella casella Nome, digitare il nome del file delle risorse e scegliere Aggiungi.

Visual Web Developer apre il file nell'editor delle risorse gestite. L'editor visualizza la griglia in cui è possibile inserire nomi (tasti), valori e commenti facoltativi.

Digitare il nome dei tasti e i valori per ogni risorsa necessaria all'applicazione, quindi salvare il file.

Nota:
Si consiglia di non cercare di incorporare un grafico direttamente nel file delle risorse poiché i controlli non leggono la stringa delle risorse come file di immagine in tempo reale. I file delle risorse rappresentano i grafici tramite la memorizzazione dell'URL del grafico come stringa.

Per creare file di risorse per altre lingue, copiare il file in Solution Explorer o in Windows Explorer, quindi rinominarlo utilizzando uno dei seguenti modelli:
- Per i file di risorse globali:
  
  nome.lingua.resx
  
  nome.lingua-impostazioni cultura.resx
- Per i file di risorse locali:
  
  nomePaginaOControllo.estensione.lingua.resx
  
  nomePaginaOControllo.estensione.lingua-impostazioni cultura.resx
Ad esempio, se viene creato un file di risorse globali denominato WebResources.resx per la traduzione in arabo d'Egitto, rinominare il file copiato WebResources.ar-eg.resx. Per creare un file di risorse correlato per la traduzione in spagnolo senza l'indicazione delle impostazioni cultura, rinominare il file copiato WebResources.es.resx. Si noti che per i file di risorse locali, il nome del file delle risorse è il nome del controllo o della pagina, inclusa l'estensione del nome del file e le informazioni relative alla lingua e alle impostazioni cultura.
Aprire il file copiato e tradurre ogni valore, lasciando invariati i nomi (tasti).
Ripetere i passaggi 6 e 7 per tutte le altre lingue che si desidera utilizzare.

Creazione di file di risorse da una pagina Web

Questa funzionalità non è disponibile in Visual Web Developer Express.

Per generare un file di risorse locali da una pagina Web ASP.NET

Aprire la pagina per la quale si desidera creare un file di risorse.
Passare alla visualizzazione Progettazione.
Dal menu Strumenti, scegliere Genera risorsa locale.

Visual Web Developer crea la cartella App_LocalResources, se non esiste. Visual Web Developer crea quindi il file di risorse di base in una lingua neutrale per la pagina corrente, che comprende un insieme di tasto/nome per ogni proprietà del controllo o della pagina che deve essere localizzata. Infine, Visual Web Developer aggiunge un attributo meta a ogni controllo server Web ASP.NET per configurare il controllo per l'utilizzo della localizzazione implicita. Per ulteriori informazioni sulla localizzazione implicita ed esplicita, vedere Cenni preliminari sulle risorse delle pagine Web ASP.NET e Procedura: utilizzare le risorse per impostare i valori delle proprietà nei controlli server Web (Visual Studio).

Digitare il valore per ogni risorsa necessaria all'applicazione, quindi salvare il file.

Nota:
Si consiglia di non cercare di incorporare un grafico direttamente nel file delle risorse poiché i controlli non leggono la stringa delle risorse come file di immagine in tempo reale. I file delle risorse rappresentano i grafici tramite la memorizzazione dell'URL del grafico come stringa.

Se le ultime modifiche apportate al file di risorse non vengono visualizzate, aggiornare la visualizzazione Progettazione passando dalla visualizzazione Origine alla visualizzazione Progettazione.
Creare i file di risorse per ulteriori lingue, seguendo i passaggi 6 e 7 della procedura precedente.

Per generare un file di risorse globali in Visual Web Developer

In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del sito Web, scegliereAggiungi nuovo elemento, quindi fare clic su File di risorse.

Visual Web Developer chiede all'utente se desidera posizionare il file nella cartella App_GlobalResources e si offre di creare la cartella.
Scegliere Sì.

Digitare il valore per ogni risorsa necessaria all'applicazione, quindi salvare il file.

Nota:
Si consiglia di non cercare di incorporare un grafico direttamente nel file delle risorse poiché i controlli non leggono la stringa delle risorse come file di immagine in tempo reale. I file delle risorse rappresentano i grafici tramite la memorizzazione dell'URL del grafico come stringa.

Se le ultime modifiche apportate al file di risorse non vengono visualizzate, aggiornare la visualizzazione Progettazione passando dalla visualizzazione Origine alla visualizzazione Progettazione.

Per creare file di risorse per altre lingue, copiare il file in Solution Explorer o in Windows Explorer, quindi rinominarlo utilizzando uno dei seguenti modelli:

nome.lingua.resx

nome.lingua-impostazioni cultura.resx

Nota:
Quando si assegna un nome ai file di risorse, non includere .aspx, poiché potrebbe verificarsi un conflitto di denominazione. Ad esempio, la cartella Resource non può contenere due file con nomi quali resTestPage.resx e resTestPage.aspx.resx. In questo caso, la risoluzione dei nomi file creerebbe un conflitto di denominazione e un conseguente errore in fase di compilazione.