Risorse in formato di file RESOURCES

Articolo
09/12/2008

Aggiornamento: novembre 2007

La classe ResourceWriter è progettata in modo specifico per creare file RESOURCES. È importante tener presente che è possibile salvare oggetti solo nei file di risorse RESX e RESOURCES. Solo i file di risorse in formato RESOURCES devono essere incorporati in un eseguibile di runtime o compilati in un assembly satellite. Per creare file RESOURCES è possibile utilizzare la classe ResourceWriter direttamente da codice oppure utilizzare il Generatore di file di risorse (Resgen.exe).

Nota:
Non utilizzare file di risorse per archiviare password, informazioni riservate o dati personali.

Utilizzo della classe ResourceWriter

La classe ResourceWriter può essere utilizzata per creare un file RESX direttamente da codice. Creare un ResourceWriter specificando un nome file univoco. Successivamente, chiamare metodo ResourceWriter.AddResource per ciascuna stringa da aggiungere al file. Chiamare infine il metodo ResourceWriter.Close per scrivere le stringhe nel file di risorse e chiudere l'oggetto ResourceWriter. Nell'esempio che segue viene illustrato questo processo.

Imports System
Imports System.Resources

Public Class SampleClass

    Public Shared Sub Main()
        ' Create a resource writer.
        Dim rw As IResourceWriter
        rw = new ResourceWriter("myStrings.resources")
        ' Add resources to the file.
        rw.AddResource("color1", "red")
        rw.AddResource("color2", "green")
        rw.AddResource("color3", "blue")
        ' Close the ResourceWriter.
        rw.Close()
    End Sub
End Class

using System;
using System.Resources;

public class SampleClass
{
    public static void Main()
    {
        // Create a resource writer.
        IResourceWriter rw = new ResourceWriter("myStrings.resources");
        // Add resources to the file.
        rw.AddResource("color1", "red");
        rw.AddResource("color2", "green");
        rw.AddResource("color3", "blue");
        // Close the ResourceWriter.
        rw.Close();
    }
}

Utilizzo di Resgen.exe

Generatore di file di risorse (Resgen.exe) converte i file TXT in file RESOURCES eseguendo il wrapping dei metodi implementati dalla classe ResourceWriter. Resgen.exe consente inoltre di riconvertire i file con estensione resources in file txt mediante il wrapping dell'oggetto ResourceReader.

Nota:
Quando un file di testo viene letto da Resgen.exe, i commenti vengono persi e non verranno scritti nel file RESOURCES o RESX risultante.

Se il file di testo contiene nomi di risorsa duplicati, lo strumento Resgen.exe genera un avviso e ignora i nomi duplicati.

Il seguente comando Resgen.exe crea il file di risorse strings.resources dal file di input strings.txt.

resgen strings.txt

Se si desidera che il nome del file di output sia diverso da quello del file di input, sarà necessario specificare il nome del file di output in modo esplicito. Il comando seguente crea il file di risorse MyApp.resources dal file di input strings.txt.

resgen strings.txt MyApp.resources

Il comando seguente crea un file di testo strings.txt dal file di input strings.resources. Si noti che è necessario eseguire questo tipo di conversione esclusivamente su un file RESOURCES che contiene solo stringhe. I riferimenti a oggetti non possono essere scritti nel file TXT.

resgen strings.resources strings.txt

Resgen.exe converte i file RESX in file RESOURCES eseguendo il wrapping dei metodi implementati dalla classe ResourceWriter. Resgen.exe consente anche di riconvertire i file RESOURCES in file RESX mediante il wrapping di ResourceReader.

Il seguente comando Resgen.exe crea il file di risorse items.resources dal file di input items.resx.

resgen items.resx

Il comando seguente crea il file RESX items.resx dal file di input items.resources. Si noti che durante la conversione di un file RESX in un file RESOURCES tutti gli oggetti rimangono inalterati.