Recursos en formato de archivos de texto
Los archivos de texto (.txt) sólo pueden contener recursos de cadena. Siempre que un archivo de texto se guarde convenientemente, puede especificar cadenas usando uno de los tres esquemas de codificación: UTF-16 con el orden de bytes little-endian, UTF-16 con el orden de bytes big-endian o UTF-8. Por ejemplo, si desea guardar y usar caracteres del alemán, guarde el archivo de texto usando la codificación UTF-8 en lugar de usar una página de códigos 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
Resgen.exe (Generador de archivos de recursos)