Winres.exe (Éditeur de localisation des ressources Windows)

L’Éditeur de localisation des ressources Windows, Winres.exe, est un outil de disposition visuelle qui permet aux experts de localiser les ressources d’interface utilisateur Windows Forms utilisées par les formulaires. Vous pouvez créer les fichiers .resx ou .resources utilisés comme entrée pour Winres.exe à l’aide d’un environnement de conception visuelle 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.

Syntaxe

winres resourceFile
winres /?

Arguments

Remarques

L’état des éléments d’interface utilisateur d’un formulaire dans un projet Windows Forms est généralement stocké dans des fichiers de ressources, qui sont des fichiers XML avec l’extension .resx ou les versions binaires compilées correspondantes avec l’extension .resources. Winres.exe est un outil qui permet une modification limitée de l’un ou l’autre type de fichier en dehors de l’environnement de conception Visual Studio. Plus précisément, il permet les types d’opérations d’édition suivants :

• Un fichier de ressources de culture neutre ou spécifique peut être modifié pour modifier les propriétés de l’interface utilisateur du formulaire ou de ses contrôles, tels que leur texte, leur taille ou leur position.
• Les fichiers de ressources de culture neutres ou spécifiques peuvent être générés à partir du fichier de ressources par défaut.
• Un fichier de ressources de culture peut être enregistré sous la forme d’un autre fichier de ressources de culture. Par exemple, un fichier de ressources anglais (États-Unis) peut être enregistré en tant que fichier de ressources polonais. En règle générale, le nouveau fichier sera ensuite modifié pour être compatible avec la nouvelle culture.

Consultez également l’organisation hiérarchique des ressources pour la localisation ou l’organisation hiérarchique des ressources pour la localisation.

Winres.exe ne peut pas convertir un fichier .resx en son fichier .resources correspondant ; utilisez plutôt l’outil Resgen.exe. Pour plus d’informations sur Resgen.exe, consultez Resgen.exe (Générateur de fichiers de ressources).

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

Si Winres.exe ne peut pas résoudre le type d’un contrôle, il crée un contrôle d’espace réservé dans le fichier .resx ou .resources localisé. Le contrôle d’espace réservé apparaît sur le formulaire Windows Forms sous la forme d’une fenêtre hachurée. La taille et la position de la fenêtre hachurée correspondent à celle du contrôle réel. Toutes les propriétés localisables disponibles pour le contrôle d’espace réservé apparaissent dans la Properties fenêtre. Toutes les modifications apportées au contrôle d’espace réservé sont enregistrées pour le contrôle réel.

Winres.exe et Visual Studio

En règle générale, 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. La compatibilité des versions, comme décrit plus loin, peut vous empêcher de passer d’un outil à l’autre.

L’avantage de Visual Studio est que vous pouvez l’utiliser pour développer et localiser une application. Pour localiser un formulaire, une fois le développement terminé, définissez les formulaires (la Localizable propriété dans l’éditeur LocalizableAttributeProperties) sur true et remplacez sa Language propriété par la culture cible souhaitée. Ensuite, modifiez les chaînes et ajustez l’emplacement et la taille des contrôles pour prendre en charge les chaînes de la culture cible. Lorsque vous enregistrez le fichier .resx localisé, Visual Studio écrit uniquement les propriétés localisables (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 correct du répertoire.

Bien que Visual Studio fournit un environnement de développement et de localisation intégré, Winres.exe est l’outil recommandé pour l’utiliser si la localisation est effectuée par des localiseurs tiers. Étant donné que Winres.exe est un outil de localisation uniquement, il permet une séparation plus nette du code d’une application des formulaires à localiser, ce qui est plus pratique pour gérer les grands projets.

Utilisation de Winres.exe

Pour localiser à l’aide de 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é du formulaire (propriété Localizable dans l’éditeur LocalizableAttributeProperties) truesur , puis désactivez le fichier .resx pour la culture par défaut sur un localiseur tiers. Ce fichier .resx contient des informations supplémentaires que Winres.exe utilise pour recréer une version au moment du design du formulaire d’origine.

Les versions finales des fichiers de ressources de 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 dispose des fonctionnalités et fonctionnalités suivantes :

• Winres peut fonctionner en mode fichier unique (SFM) ou en mode de fichier Visual Studio (VSFM). SFM est le mode hérité où des informations complètes sur le formulaire et son contenu sont stockées dans le fichier de ressources. VSFM stocke uniquement les modifications culturelles dans le fichier de ressources.

• Fenêtre de création de rapports d’erreurs, ancrée en bas à gauche de la fenêtre principale.

• Les touches d’accès à chaud peuvent être vérifiées pour les doublons : dans le Format menu, cliquez sur la commande Vérifier les touches d’accès.

Compatibilité des versions

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

Examples

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 Ouvrir > le fichier et accédez au fichier pour l’ouvrir.

   - ou -

   Spécifiez le fichier à ouvrir à 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
   

   Note

   Si le formulaire dont vous modifiez les ressources est un formulaire hérité, l’assembly contenait le formulaire hérité et l’assembly contenant le formulaire hérité (dérivé) doit être inscrit dans le Global Assembly Cache (GAC), ou doit résider dans le même répertoire que WinRes.exe. Pour plus d’informations sur l’installation des composants .NET Framework dans le GAC, consultez Global Assembly Cache.

3. Sélectionnez des contrôles sur le formulaire et modifiez leurs Text propriétés pour refléter la culture localisée et sa langue. Déplacez ou redimensionnez les contrôles si nécessaire pour prendre en charge le texte localisé.

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

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

   L’outil enregistre le fichier à l’aide de la convention d’affectation de noms attendue par le runtime pour les fichiers de ressources localisés. Par exemple, si vous localisez TestApp.resources l’allemand en Allemagne, l’outil enregistre le fichier sous TestApp.de-DE.resources. Si vous localisez TestApp.resx l’allemand en Allemagne, 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 culture prédéfinis utilisés par le runtime, consultez la CultureInfo classe.

Voir aussi

• LocalizableAttribute
• CultureInfo
• ResourceManager
• ResourceReader
• ResourceWriter
• Outils
• Les ressources dans les applications .NET
• Globalisation et localisation