Winres.exe (Windows Resource Localization Editor)

  • Article

Windows Resource Localization Editor, Winres.exe, est un outil de présentation visuelle qui permet aux experts en localisation de localiser les ressources de l’interface utilisateur Windows Forms utilisées par des formulaires. Vous pouvez créer les fichiers .resx ou .resources servant d’entrée à Winres.exe à l’aide d’un environnement de design visuel tel que Microsoft Visual Studio. Pour plus d’informations sur le déploiement de ressources dans des applications .NET Framework, consultez Ressources dans les applications .NET.

Winres.exe est installé avec Visual Studio. Pour exécuter l’outil, utilisez l’invite de commandes développeur Visual Studio ou Visual Studio Developer PowerShell.

Avertissement

N’ouvrez pas les fichiers non approuvés avec cet outil. Si le fichier est un fichier binaire, il est désérialisé à l’aide de la désérialisation binaire, ce qui est dangereux. Pour plus d’informations, consultez Risques de désérialisation liés à l’utilisation de BinaryFormatter et des types associés.

Syntaxe

winres resourceFile
winres /?

Arguments

Argument Description
resourceFile Fichier de ressources à localiser. Ce fichier doit être un fichier de ressources .resx ou .resources de formulaire Windows Forms généré par le concepteur Visual Studio . Winres.exe ne peut pas ouvrir les fichiers génériques .resx ou .resources.
Option Description
/? Affiche la syntaxe et les options de commande de l'outil.

Notes

L’état des éléments d’interface d’un formulaire dans un projet Windows Forms est généralement stocké dans des fichiers de ressources, c’est-à-dire des fichiers XML portant l’extension .resx ou leurs versions binaires et compilées correspondantes, portant l’extension .resources. Winres.exe est un outil qui permet d'éditer de façon limitée les deux types de fichiers en dehors de l'environnement de design Visual Studio. Vous pouvez y effectuer les types de modifications suivants :

  • Un fichier de ressources de culture spécifique ou neutre peut être modifié pour changer les propriétés d'interface utilisateur du formulaire ou de ses contrôles, notamment le texte, la taille ou la position.
  • Les fichiers de ressources de culture neutre ou spécifique peuvent être générés à partir du fichier de ressources par défaut.
  • Un fichier de ressources avec une culture spécifique peut être enregistré en tant que fichier de ressources d'une autre culture. Par exemple, un fichier de ressources anglais (États-Unis) peut être enregistré en tant que fichier de ressources polonais. En général, le nouveau fichier est modifié par la suite pour être compatible avec la nouvelle culture.

Consultez également Organisation hiérarchique des ressources pour la localisation ou Organisation hiérarchique des ressources pour la localisation.

Winres.exe ne peut pas convertir un fichier .resx en fichier .resources correspondant ; utilisez à la place l'outil Resgen.exe. Pour plus d’informations sur Resgen.exe, consultez Resgen.exe (Générateur de fichier de ressources).

Winres.exe est une application graphique qui recrée une version d’un formulaire Windows Forms au moment du design simplement à partir du fichier de ressources, sans devoir accéder au code source. Winres.exe héberge le concepteur de formulaires Windows Forms et la fenêtre Propriétés de Visual Studio. Ces fonctionnalités permettent une modification visuelle d'un fichier .resources ou .resx contenant un formulaire Windows Forms. En règle générale, les localisateurs utilisent Winres.exe pour modifier les étiquettes des contrôles, et ajuster l’emplacement et la taille des contrôles afin d’adapter les étiquettes à la culture cible.

Si Winres.exe ne parvient pas à résoudre le type d'un contrôle, il crée un contrôle réservé dans le fichier .resx ou .resources localisé. Ce contrôle apparaît sur le formulaire Windows Forms sous la forme d'une fenêtre hachurée. dont la taille et la position correspondent à celles du contrôle réel. Toutes les propriétés localisables disponibles pour le contrôle réservé apparaissent dans la fenêtre Propriétés. Toute modification apportée au contrôle réservé est enregistrée dans le contrôle réel.

Winres.exe et Visual Studio

En général, avant de commencer à localiser les formulaires Windows Forms d'une application, vous devez décider si vous souhaitez utiliser Visual Studio ou Winres.exe comme outil de localisation. Certains problèmes de compatibilité de versions, décrits ultérieurement, peuvent vous empêcher de basculer d'un outil à l'autre.

L'avantage de Visual Studio réside dans le fait qu'il permet à la fois de développer et de localiser une application. Pour localiser un formulaire, une fois le développement terminé, définissez la propriété LocalizableAttribute du formulaire (propriété Localizable dans l’éditeur Propriétés) à la valeur true et changez sa propriété Language à la culture cible souhaitée. Ensuite, modifiez les chaînes et réglez l'emplacement et la taille des contrôles en fonction des chaînes de la culture cible. Lors de l'enregistrement du fichier .resx localisé, Visual Studio n'écrit que les propriétés localisables (les propriétés modifiées dans la culture cible) dans le fichier. Visual Studio crée automatiquement un assembly satellite pour le fichier .resx localisé à l'emplacement de répertoire correct.

Visual Studio fournit un environnement de développement et de localisation intégré, mais Winres.exe est l’outil recommandé si la localisation est effectuée par des localisateurs tiers. Dans la mesure où Winres.exe est exclusivement un outil de localisation, il permet de mieux séparer le code d'une application des formulaires à localiser et s'avère plus pratique pour gérer des projets volumineux.

Utilisation de Winres.exe

Si vous choisissez de localiser avec Winres.exe, vous devez d’abord développer une application à l’aide d’un concepteur visuel tel que le concepteur Windows Forms dans Visual Studio. Une fois le développement terminé, définissez la propriété LocalizableAttribute du formulaire (propriété Localizable dans l’éditeur Propriétés) à la valeur true, puis transmettez le fichier .resx de la culture par défaut à un localisateur tiers. Ce fichier .resx contient des informations supplémentaires dont se sert Winres.exe pour recréer une version du formulaire d’origine au moment du design.

Notes

Winres.exe ne peut pas être utilisé pour modifier le fichier de ressources par défaut. Winres.exe interprète toutes les propriétés modifiées comme des propriétés localisées et les enregistre dans le fichier de ressources de la culture cible.

Les versions finales des fichiers de ressources de la culture peuvent enfin être utilisées pour créer des versions localisées de l'application. Pour plus d’informations, consultez Ressources dans les applications .NET.

Winres.exe a les fonctions et fonctionnalités suivantes :

  • Winres peut fonctionner en mode fichier unique (SFM) ou en mode fichier Visual Studio (VSFM). Le mode fichier unique est le mode hérité (legacy) où l'intégralité des informations relatives au formulaire et à son contenu sont stockées dans le fichier de ressources. Le mode fichier Visual Studio stocke uniquement les modifications relatives à la culture dans le fichier de ressources.

  • Fenêtre de rapport d’erreurs, ancrée dans le coin inférieur gauche de la fenêtre principale.

  • Vous pouvez vérifier s’il existe des doublons de touches d’accès rapide : dans le menu Format, cliquez sur la commande Vérifier les touches d’accès rapide.

Compatibilité des versions

Vous devez utiliser la version de Winres.exe publiée avec le .NET Framework que vous utilisez. Le tableau suivant répertorie les versions compatibles :

Visual Studio .NET Framework Winres.exe
Visual Studio .NET 2002 1.0 1.0
Visual Studio .NET 2003 1.1 1,1
Visual Studio 2005 2.0 2.0
Visual Studio 2008 3.0 et 3.5 3.0 et 3.5
Visual Studio 2010 4.0 4.0
Visual Studio 2017 4.6 4.6

Notes

Bien que le mode fichier Visual Studio présente l'avantage d'être compatible avec Visual Studio, dans la mesure où il stocke uniquement les valeurs modifiées dans le fichier de ressources, Winres.exe exige que les parents du fichier de ressources actif figurent dans le même répertoire. Par exemple, TestApp.de-DE.resources, un fichier de ressources en allemand, nécessite la présence du fichier de ressources par défaut, TestApp.resx, et éventuellement celle du fichier de ressources de culture neutre, TestApp.de.resources.

Exemples

Pour localiser un fichier .resx ou .resources associé à un formulaire

  1. Pour exécuter Winres.exe, entrez winres dans l’invite de commandes développeur.

  2. Pour ouvrir les ressources par défaut d’un formulaire à localiser, sélectionnez Fichier > Ouvrir et accédez au fichier pour l’ouvrir.

    -ou-

    Spécifiez le fichier à ouvrir dans la ligne de commande lorsque vous démarrez Winres.exe. La commande suivante démarre Winres.exe et charge le formulaire associé à TestApp.resx dans le Concepteur de formulaires.

    winres TestApp.resx

    La commande suivante démarre Winres.exe et charge le formulaire associé à TestApp.resources dans le Concepteur de formulaires.

    winres TestApp.resources

    Notes

    Si le formulaire dont vous modifiez les ressources est un formulaire hérité, à la fois l'assembly qui contient le formulaire hérité et l'assembly qui contient le formulaire héritant (dérivé) doivent être enregistrés dans le Global Assembly Cache (GAC) ou résider dans le même répertoire que WinRes.exe. Pour plus d’informations sur l’installation des composants du .NET Framework dans le GAC, consultez Global Assembly Cache.

  3. Sélectionnez les contrôles sur le formulaire et modifiez leurs propriétés Text et autres propriétés pour refléter la culture localisée et sa langue. Si nécessaire, déplacez ou redimensionnez les contrôles pour tenir compte du texte localisé.

  4. Pour enregistrer la version localisée du fichier .resx ou .resources, cliquez sur l’icône Enregistrer ou sélectionnez Fichier > Enregistrer. L’outil affiche la fenêtre Choisir la culture.

  5. Sélectionnez la culture appropriée et le mode de fichier, puis cliquez sur OK.

    L’outil enregistre le fichier à l’aide de la convention de nommage que le runtime attend pour les fichiers de ressources localisés. Par exemple, si vous localisez TestApp.resources en allemand, l'outil enregistre le fichier sous TestApp.de-DE.resources. Si vous localisez TestApp.resx en allemand, l'outil enregistre le fichier sous TestApp.de-DE.resx. Pour plus d’informations sur les conventions d’affectation de noms des ressources, consultez Package et Déployer des ressources. Pour obtenir la liste des noms de cultures prédéfinis utilisés au moment de l’exécution, consultez la classe CultureInfo.

Voir aussi