Ressources au format de fichier texte
Les fichiers texte (.txt) ne peuvent contenir que des ressources chaîne. Du moment que vous enregistrez un fichier texte de la façon appropriée, vous pouvez spécifier des chaînes à l'aide de l'un de trois modèles d'encodage : UTF-16 dans un ordre d'octet avec primauté des octets de poids faible (little-endian) ou ordre d'octet avec primauté des octets de poids fort (big-endian), ou UTF-8. Par exemple, si vous souhaitez enregistrer et utiliser des caractères allemands, enregistrez votre fichier texte à l'aide de l'encodage UTF-8 plutôt qu'à l'aide d'une page de codes ANSI spécifique. Pour plus d'informations sur l'utilisation des schémas d'encodage, consultez Unicode dans le .NET Framework.
Notes
L'outil Resource File Generator (Resgen.exe) traite les fichiers comme des fichiers UTF-8 par défaut.Pour que Resgen.exe reconnaisse un fichier encodé à l'aide de UTF-16, vous devez inclure une marque d'ordre d'octet Unicode (U+FEFF) au début du fichier.
En plus des chaînes, les fichiers texte peuvent contenir des commentaires. Le nombre d'entrées contenues dans un fichier texte n'est pas limité. Vous pouvez également utiliser des espaces blancs (lignes vides) dans le fichier pour en faciliter la lecture. Il est à noter que les espaces ne sont pas inclus dans une ligne individuelle lorsqu'elle est stockée ou extraite. De plus, une chaîne vide est autorisée.
Si le fichier texte contient des noms de ressources en double, Resgen.exe émettra un avertissement et ignorera les noms en double.
Le tableau suivant décrit les types d'entrées pour les fichiers texte.
Entrée |
Description |
|---|---|
;commentaires |
Vous pouvez inclure des commentaires dans un fichier texte. Vous devez faire précéder un commentaire d'un point-virgule ou d'un signe dièse (#). Les commentaires peuvent vous aider à expliquer comment les ressources sont organisées. Par exemple, vous pouvez organiser vos ressources dans un fichier spécifique en les étiquetant par des commentaires, tels que ;exceptions, ;messages généraux, ;étiquettes de texte, ;titres formulaire, etc. Ces commentaires sont perdus lorsque vous convertissez un fichier .txt en fichier .resources. |
nom = valeur |
Vous devez spécifier les ressources chaîne comme des entrées de paire nom/valeur, où le nom est une chaîne qui décrit la ressource et la valeur est la chaîne de ressources qui sera retournée lorsque le nom est extrait par la méthode ResourceManager.GetString. Le nom et la valeur doivent être séparés par un signe égal (=). Par exemple, Msg1 = Hello, et Welcome! La valeur ne peut pas contenir des caractères de nouvelle ligne, mais vous pouvez utiliser des caractères d'échappement de style langage C, tels que \n pour représenter une nouvelle ligne et \t pour représenter un onglet. De plus, une chaîne vide est autorisée. Par exemple : MaChaîneVide=. |
Une fois que vous avez ajouté toutes les entrées souhaitées à votre fichier texte, enregistrez-le avec un nom approprié et l'extension .txt.
Notes
N'utilisez pas de fichiers de ressources pour stocker des mots de passe, des informations sensibles ou des données privées.
Vous ne pouvez pas incorporer un fichier .txt dans un assembly. Vous devez convertir votre fichier .txt en fichier .resources en utilisant l'outil Resource File Generator (Resgen.exe). Pour plus d'informations, consultez Ressources dans un fichier au format .Resources.
Voir aussi
Référence
Resgen.exe (Resource File Generator)