. Ressource nette (.resx)

RESX (Resource XML) est le format de localisation pour la plateforme .NET, prenant en charge ASP.NET Core, WPF, WinForms et Blazor. Le fichier de ressources de base (Resources.resx) contient les chaînes de la langue par défaut. Les remplacements spécifiques à la langue sont stockés dans des fichiers séparés : Resources.fr.resx, Resources.de.resx, et ainsi de suite. Le gestionnaire de ressources .NET résout le fichier correct à l'exécution en fonction de la culture actuelle du thread, en retombant sur la chaîne d'assembly satellite.

RESX est un fichier XML où chaque chaîne est un élément de données avec un attribut name (la clé) et un élément enfant value. Un élément comment stocke les notes du traducteur. Le RESX de base se compile dans l'assembly principal ; les fichiers spécifiques à la langue se compilent dans des assemblies satellites dans des sous-répertoires nommés par culture. Le type d'élément EmbeddedResource de MSBuild contrôle la compilation. Les fichiers Designer.cs générés à partir de RESX exposent les clés comme des propriétés typées pour la sécurité au moment de la compilation.

Bonne pratique : organisez les fichiers RESX par domaine fonctionnel — Auth.resx, Checkout.resx, Common.resx — et utilisez IStringLocalizer avec des paramètres génériques typés dans ASP.NET Core pour la liaison d'assembly satellite au moment de la compilation. Nommez les clés en PascalCase et évitez les espaces ou les tirets qui brisent la génération de propriétés Designer.cs. Documentez le type et l'objectif de chaque argument de format positionnel dans le commentaire de ressource. Language Monster détecte automatiquement les fichiers RESX, préserve la structure XML et les nœuds de commentaires, protège les spécificateurs de format .NET lors de la traduction et repousse les fichiers satellites complétés vers votre dépôt.

Guides de localisation pour développeurs

Localisation .NET & C#

En savoir plus Formats de fichiers