Recursos en formato de archivo .Resources

La clase ResourceWriter se ha diseñado especialmente para crear archivos .resources. Recuerde que se pueden guardar objetos sólo en los archivos .resources y .resx. Sólo deben incrustarse los archivos de recursos con formato de archivo .resources en un ejecutable de Common Language Runtime o compilarse en un ensamblado satélite. Se puede utilizar la clase ResourceWriter directamente a partir de código o utilizar el Generador de archivos de recursos (Resgen.exe) para crear archivos .resources.

Nota

No utilice archivos de recursos para almacenar contraseñas, información relativa a la seguridad o datos privados.

Usar la clase ResourceWriter

Se puede usar la clase ResourceWriter para crear un archivo .resources directamente a partir de código. Primero, cree una clase ResourceWriter con un nombre de archivo único. A continuación, llame al método ResourceWriter.AddResource para cada cadena que desee agregar al archivo. Por último, llame al método ResourceWriter.Close para escribir las cadenas en el archivo de recursos y cierre ResourceWriter. En el ejemplo siguiente se muestra este proceso.

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

Usar Resgen.exe

El Generador de archivos de recursos (Resgen.exe) convierte archivos .txt en archivos .resources ajustando los métodos implementados por la clase ResourceWriter. Resgen.exe también ajusta una clase ResourceReader, que permite utilizar la herramienta para convertir de nuevo los archivos .resources en archivos .txt.

Nota

Cuando Resgen.exe lea un archivo de texto, los comentarios se perderán y no se escribirán en el archivo .resources o .resx resultante.

Si el archivo de texto contiene nombres de recursos duplicados, Resgen.exe emitirá una advertencia y omitirá los nombres duplicados.

El siguiente comando de Resgen.exe crea el archivo de recursos strings.resources a partir del archivo de entrada strings.txt.

resgen strings.txt

Si desea que el nombre del archivo de resultados sea distinto al del archivo de entrada, especifique explícitamente el nombre del archivo de resultados. El siguiente comando de Resgen.exe crea el archivo de recursos MyApp.resources a partir del archivo de entrada strings.txt.

resgen strings.txt MyApp.resources

El siguiente comando crea un archivo de texto strings.txt a partir del archivo de entrada strings.resources. Observe que sólo debe realizar este tipo de conversión en un archivo .resources que únicamente contenga cadenas. Las referencias a objetos no se pueden escribir en el archivo .txt.

resgen strings.resources strings.txt

Resgen.exe convierte archivos .resx en archivos .resources ajustando los métodos implementados por la clase ResourceWriter. Resgen.exe también ajusta una clase ResourceReader, que permite utilizar la herramienta para convertir de nuevo los archivos .resources en archivos .resx.

El siguiente comando de Resgen.exe crea el archivo de recursos items.resources a partir del archivo de entrada items.resx.

resgen items.resx

El siguiente comando crea el archivo .resx items.resx a partir del archivo de entrada items.resources. Tenga en cuenta que al convertir un archivo .resx en un archivo .resources se conservan todos los objetos.

resgen items.resources items.resx

Nota

Si en Resgen.exe se produce un error por cualquier razón, el valor devuelto será –1.

Vea también

Referencia

Generador de archivos de recursos (Resgen.exe)

Conceptos

Crear archivos de recursos
Recursos en formato de archivos de texto
Recursos en formato de archivo .Resx