Programmi di esempio delle risorse

L'esercitazione comprende i quattro programmi di esempio riportati di seguito per illustrare l'utilizzo delle risorse in .NET Framework:

  • ResWriteRead
    Un programma console che crea un file RESOURCES, enumera le risorse utilizzando una ResourceReader ed elenca le risorse utilizzando una ResourceManager.
  • ResDump
    Un'utilità console che enumera tutte le risorse in un file RESOURCES. Basato sul semplice codice di ResWriteRead, questo esempio include anche l'elaborazione di argomenti della riga di comando.
  • ResEditor
    Un'utilità di Windows Form che consente di modificare file RESX e RESOURCES e di aggiungere bitmap, icone e stringhe. Il codice utilizzato per questa utilità è complesso. In effetti, la caratteristica più importante è un componente che consente di modificare le risorse in una finestra delle proprietà.
  • ResXGen
    Un'utilità console che converte i file grafici supportati da .NET in file RESX intermedi, che possono essere utilizzati dallo strumento generatore di file di risorse (Resgen.exe) di .NET Framework SDK.

L'esercitazione comprende anche i tre programmi descritti di seguito per illustrare l'utilizzo delle risorse localizzate:

  • WorldCalc, un programma di Windows Form che illustra la localizzazione di risorse di tipo stringa.
  • Graphic, un programma di Windows Form che illustra la localizzazione di immagini.
  • WorldDocs, un programma ASP.NET che restituisce risorse di tipo stringa e immagini localizzate.

Per illustrare in che modo le applicazioni possono utilizzare le risorse, nelle sezioni che seguono verrà brevemente descritto il funzionamento dei tre programmi di localizzazione. Le sottodirectory corrispondenti contengono tutti i file necessari per localizzare e generare questi programmi. La procedura dettagliata relativa alla creazione e all'utilizzo dei file di risorse viene illustrata più avanti nell'esercitazione.

Programma di esempio WorldCalc

Questo programma è una calcolatrice basata su componenti che utilizza stringhe di risorse per la didascalia della barra del titolo, un'etichetta, le didascalie dei pulsanti e un messaggio di errore. Questo esempio include solo tre lingue: inglese (predefinita), tedesco e tedesco (Svizzera), ma il processo è analogo per qualsiasi lingua. Se in un sistema di lingua inglese si esegue WorldCalc da Esplora risorse o da una riga di comando senza alcun argomento, verrà visualizzata la finestra illustrata di seguito.

Se invece il programma viene eseguito dalla riga di comando WorldCalc de, verrà visualizzata una finestra differente con stringhe in tedesco, come viene illustrato nella figura che segue:

Il programma può essere eseguito anche con l'opzione de-CH per passare alla lingua tedesca (Svizzera). Nella figura riportata di seguito risulta evidente che, in questo caso, l'unica stringa ad essere diversa è il saluto della barra del titolo dell'applicazione.

Programma di esempio Graphic

In questo programma viene semplicemente caricata una bitmap che rappresenta un paese/area geografica e viene visualizzata l'immagine in una casella di immagine sul form. L'esempio contiene solo le bitmap corrispondenti a diversi paesi di lingua inglese: en-US (Stati Uniti), en-CA (Canada), en-AU (Australia) ed en-GB (Regno Unito), oltre a una bitmap vuota che non specifica esplicitamente alcun paese. Il processo è comunque lo stesso per qualsiasi lingua. L'esecuzione del programma Graphic da Esplora risorse o da una riga di comando senza argomenti determina la visualizzazione della finestra riportata di seguito in un sistema di lingua inglese (Stati Uniti).

Se il sistema non è impostato su una delle lingue inglesi per la quale è fornita la bitmap della risorsa, il programma utilizza la bitmap vuota, che non è associata ad alcun paese in particolare, come viene illustrato nella figura che segue:

L'esecuzione del programma su un sistema di lingua inglese (Australia) o dalla riga di comando che segue:

Graphic en-AU

determina la visualizzazione di una finestra con una bitmap dell'Australia, come viene illustrato nella figura riportata di seguito.

È possibile anche eseguire il programma con l'opzione en-GB o en-CA per caricare la bitmap per il Regno Unito o il Canada, rispettivamente.

Programma di esempio WorldDocs

In questo esempio viene illustrato come modificare le stringhe localizzate e le immagini corrispondenti in base alla richiesta Web di un utente. La figura riportata di seguito riproduce la pagina di esempio default.aspx, in cui viene visualizzata un'immagine bitmap e del testo nella lingua predefinita dell'utente e in cui è possibile scegliere una lingua alternativa.

Vedere anche

Concetti di base sulle risorse | Creazione di risorse | Recupero di risorse tramite codice | Riepilogo delle risorse | Appendice A: ulteriori informazioni sulle risorse | Appendice B: strumenti delle risorse