Ressources au format de fichier .Resources

Article
05/15/2010

La classe ResourceWriter a été spécialement conçue pour créer des fichiers .resources. N'oubliez pas que vous ne pouvez enregistrer des objets que dans les fichiers de ressources .resources et .resx. Seuls les fichiers de ressources au format .resources doivent être incorporés dans un exécutable runtime ou compilés dans un assembly satellite. Vous pouvez utiliser directement la classe ResourceWriter à partir du code ou utiliser l'outil Resource File Generator Tool (Resgen.exe) pour créer des fichiers .resources.

Notes

N'utilisez pas de fichiers de ressources pour stocker des mots de passe, des informations sensibles ou des données privées.

Utilisation de la classe ResourceWriter

Vous pouvez utiliser la classe ResourceWriter pour créer un fichier .resources directement à partir du code. Créez tout d'abord ResourceWriter avec un nom de fichier unique. Ensuite, appelez la méthode ResourceWriter.AddResource pour chaque chaîne à ajouter au fichier. Pour finir, appelez la méthode ResourceWriter.Close pour écrire les chaînes dans le fichier de ressources et fermer ResourceWriter. L'exemple suivant illustre ce processus.

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();
    }
}

Utilisation de Resgen.exe

L'outil Resource File Generator Tool (Resgen.exe) convertit les fichiers .txt en fichiers .resources en encapsulant les méthodes implémentées par la classe ResourceWriter. Resgen.exe encapsule également ResourceReader, qui vous permet d'utiliser l'outil pour convertir les fichiers .resources en fichiers .txt.

Notes

Lorsque Resgen.exe lit un fichier texte, les commentaires sont perdus et ne sont pas écrits dans le fichier .resources ou .resx qui en résulte.

Si le fichier texte contient des noms de ressources en double, Resgen.exe émettra un avertissement et ignorera les noms en double.

La commande suivante de Resgen.exe crée le fichier de ressources strings.resources à partir du fichier d'entrée strings.txt.

resgen strings.txt

Si vous souhaitez que le nom du fichier de sortie soit différent du fichier d'entrée, vous devez explicitement spécifier le nom du fichier de sortie. La commande suivante crée le fichier de ressources MyApp.resources à partir du fichier d'entrée strings.txt.

resgen strings.txt MyApp.resources

La commande suivante crée un fichier texte strings.txt à partir du fichier d'entrée strings.resources. Notez que vous devez exécuter ce type de conversion uniquement sur un fichier .resources qui contient exclusivement des chaînes. Toute référence d'objet ne peut pas être écrite dans le fichier .txt.

resgen strings.resources strings.txt

Resgen.exe convertit les fichiers .resx en fichiers .resources en encapsulant les méthodes implémentées par la classe ResourceWriter. Resgen.exe encapsule également ResourceReader, qui vous permet d'utiliser l'outil pour convertir les fichiers .resources en fichiers .resx.

La commande suivante de Resgen.exe crée le fichier de ressources items.resources à partir du fichier d'entrée items.resx.

resgen items.resx

La commande suivante crée le fichier .resx items.resx à partir du fichier d'entrée items.resources. Notez que lors de la conversion d'un fichier .resx en un fichier .resources, tous les objets sont conservés.