Ressources au format de fichier texte
Mise à jour : novembre 2007
Les fichiers texte (.txt) ne peuvent contenir que des ressources chaîne. Tant que vous enregistrez un fichier texte de manière appropriée, vous pouvez spécifier des chaînes à l'aide de l'un des trois schémas de codage suivants : UTF-16 avec primauté des octets de poids faible, UTF-16 avec primauté des octets de poids fort ou UTF-8. Par exemple, si vous souhaitez enregistrer et utiliser des caractères allemands, enregistrez votre fichier texte à l'aide du codage UTF-8 plutôt que d'utiliser une page de code ANSI spécifique. Pour plus d'informations sur l'utilisation des schémas de codage, consultez Unicode dans le .NET Framework.
.gif "Remarque") Remarque : |
|---|
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 codé à 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 |
|---|---|
;Commentaire |
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.
| Remarque : |
|---|
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
Concepts
Création de fichiers de ressources
Ressources au format de fichier .Resources