Compartir a través de


Recursos en formato de archivos de texto

Los archivos de texto (.txt) sólo pueden contener recursos de cadena. Cuando se guarda correctamente un archivo de texto, se pueden especificar cadenas mediante uno de los tres esquemas de codificación: UTF-16 en orden de byte big-endian (byte significativo derecho) o little-endian (byte significativo izquierdo), o UTF-8. Por ejemplo, si desea guardar y utilizar caracteres alemanes, guarde el archivo de texto mediante la codificación UTF-8 en vez de usar una página de código ANSI específica. Para obtener más información sobre el uso de codificaciones, vea Unicode en .NET Framework.

Nota

El Generador de archivos de recursos (Resgen.exe) considera de manera predeterminada los archivos como UTF-8. Para que Resgen.exe reconozca un archivo codificado mediante UTF-16, es preciso incluir una marca de orden de bytes Unicode (U+FEFF) al principio del archivo.

Además de las entradas de cadena, los archivos de texto pueden contener comentarios. En los archivos de texto se puede incluir un número ilimitado de entradas. También se pueden utilizar espacios en blanco (líneas vacías) en el archivo para que sea más fácil de leer. Cuando se almacena o se recupera una línea individual, no van incluidos los espacios adyacentes. Además, se admite el uso de una cadena vacía.

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

En la siguiente tabla se describen los tipos de entrada para los archivos de texto.

Entrada Descripción

;comentarios

De manera opcional, se pueden incluir comentarios en un archivo de texto. El comentario debe ir precedido de un punto y coma o un signo de número (#). Los comentarios pueden ayudar a explicar cómo están organizados los recursos. Por ejemplo, se pueden organizar los recursos en un archivo determinado etiquetándolos con comentarios como ;excepciones, ;mensajes generales, ;etiquetas de texto, ;títulos de formulario, etc. Estos comentarios se pierden al convertir un archivo .txt en un archivo .resources.

nombre = valor

Los recursos de cadena deben especificarse como entradas de pares de nombre y valor, donde el nombre es una cadena que describe el recurso y el valor es la cadena de recurso que se devolverá cuando se recupere el nombre mediante el método ResourceManager.GetString. El nombre y el valor deben separarse mediante el signo igual (=). Por ejemplo, Msg1 = Hello, and Welcome! El valor no puede contener caracteres de línea nuevos, pero se pueden utilizar caracteres de escape de estilo de lenguaje C como \n para representar una línea nueva y \t para representar una tabulación. Además, se admite el uso de una cadena vacía. Por ejemplo: MiCadenaVacia=.

Cuando haya agregado todas las entradas deseadas en el archivo de texto, guárdelo con el nombre apropiado y la extensión .txt.

Nota

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

No se puede incrustar un archivo .txt en un ensamblado. Se ha de convertir el archivo .txt en un archivo .resources mediante el Generador de archivos de recursos (Resgen.exe). Para obtener más información, vea Recursos en formato de archivo .Resources.

Vea también

Referencia

Generador de archivos de recursos (Resgen.exe)

Conceptos

Crear archivos de recursos
Recursos en formato de archivo .Resources