Gérer les ressources d’une application
Les fichiers de ressources sont des fichiers qui font partie d’une application, mais qui ne sont pas compilés, par exemple, des fichiers icône ou des fichiers audio. Comme ces fichiers ne font pas partie du processus de compilation, vous pouvez les modifier sans avoir à recompiler vos fichiers binaires. Si vous envisagez de localiser votre application, vous devez utiliser des fichiers de ressources pour toutes les chaînes et autres ressources qui doivent être modifiées quand vous localisez votre application.
Attention
Les ressources dans les fichiers .resx peuvent être sérialisées à l’aide de BinaryFormatter, ce qui n’est pas sécurisé. Incluez uniquement ces fichiers .resx dans votre processus de génération en lequel vous avez confiance.
Pour plus d’informations sur les ressources des applications .NET, consultez Ressources dans les applications .NET.
Utiliser des ressources
Dans un projet de code managé, ouvrez la fenêtre de propriétés du projet. Vous pouvez ouvrir la fenêtre de propriétés en procédant de l’une des façons suivantes :
- En cliquant avec le bouton droit sur le nœud du projet dans l’Explorateur de solutions, puis en sélectionnant Propriétés
- En tapant propriétés de projet dans la zone de recherche Ctrl+Q
- En appuyant sur Alt+Entrée dans l’Explorateur de solutions
Sélectionnez l’onglet Ressources. Vous pouvez ajouter un fichier .resx si votre projet n’en contient pas déjà un, ajouter et supprimer différents types de ressources, et modifier des ressources existantes.
Améliorations de l’explorateur de ressources dans Visual Studio 2022 et les versions ultérieures
À partir de Visual Studio 2022 version 17.11, l’explorateur de ressources a été considérablement amélioré. Veuillez consulter la section Présentation de l’explorateur de ressources remanié dans Visual Studio.
Pour utiliser le nouvel Explorateur de ressources, vous devez avoir un projet .NET contenant un ou plusieurs fichiers de ressources (.resx). Pour ouvrir l’Explorateur de ressources, faites un clic droit sur n’importe quel fichier de ressources dans l’Explorateur de solutions et sélectionnez Ouvrir avec>Explorateur de ressources. Vous pouvez également utiliser le raccourci clavier Ctrl+Alt+R.
Lorsque vous ouvrez le nouvel Explorateur de ressources, sur le côté gauche, vous voyez un aperçu de toutes les ressources que vous avez stockées ainsi que les localisations pour chaque fichier. Vous pouvez configurer les localisations visibles dans la grille de données. Cette interface vous permet de comparer les traductions côte à côte et de les modifier directement.
Recherche de chaînes de ressources
En haut à gauche de la grille, vous pouvez utiliser la zone de recherche pour effectuer une recherche textuelle dans tous vos fichiers de ressources. Pour rechercher une ressource, tapez dans la zone de recherche de la barre d’outils et appuyez sur Entrée. La grille de données affichera uniquement les ressources correspondant à votre requête dans leur nom, valeur ou commentaire. Vous pouvez utiliser des caractères génériques (*) pour effectuer des correspondances partielles, et des guillemets (") pour effectuer des correspondances exactes.
Ajouter des commentaires à des traductions spécifiques d’une ressource
Les commentaires sont un moyen utile de fournir plus d’informations ou de contexte pour une ressource, comme la signification, l’utilisation ou le ton d’une chaîne. Dans l’Explorateur de ressources, vous pouvez ajouter des commentaires à chaque traduction d’une ressource et les visualiser tous en même temps dans la grille de données.
Pour ajouter un commentaire à une ressource, sélectionnez la cellule correspondant à la traduction que vous souhaitez commenter, puis cliquez sur le bouton Modifier le commentaire dans la barre d’outils, ou appuyez sur Shift+Entrée. Une zone de commentaire apparaît sous la cellule, où vous pouvez taper votre commentaire. Appuyez sur Entrée pour enregistrer le commentaire, ou sur Esc pour l’annuler.
Vous pouvez modifier ou supprimer des commentaires existants en cliquant sur la zone de commentaire ou en utilisant le même raccourci clavier. Pour voir tous les commentaires pour une ressource, recherchez l’icône en forme de petit triangle dans le coin de chaque cellule qui contient un commentaire. Vous pouvez survoler l’icône pour voir une info-bulle avec le texte du commentaire ou cliquer dessus pour ouvrir la zone de commentaire.
Les commentaires sont disponibles pour plusieurs utilisateurs des fichiers de ressources. Le traducteur, un développeur ou un gestionnaire de ressources peuvent laisser des notes, des questions, des explications ou des mises en garde à côté des traductions. Une petite icône dans le coin de chaque cellule indique la présence d’un commentaire.
Filtrer les ressources
Pour filtrer les ressources, cliquez sur l’icône de filtre dans la barre d’outils et sélectionnez les critères que vous souhaitez appliquer. Vous pouvez filtrer les ressources par nom, valeur, commentaire, type ou fichier.
| Filter | Description |
|---|---|
| Nom | Afficher uniquement les ressources qui ont un certain nom ou préfixe. |
| Valeur | Afficher uniquement les ressources qui ont une certaine valeur ou qui contiennent une certaine chaîne. |
| Commentaire | Afficher uniquement les ressources qui ont un commentaire ou qui contiennent une certaine chaîne dans leur commentaire. |
| Type | Afficher uniquement les ressources qui ont un certain type, comme chaîne, image ou icône. |
| File | Afficher uniquement les ressources appartenant à un certain fichier ou à une certaine culture. |
Vous pouvez combiner plusieurs filtres pour affiner vos résultats et les effacer en cliquant sur le bouton Effacer le filtre.
Validation et avertissements
Les espaces réservés sont des jetons spéciaux remplacés par des valeurs dynamiques au moment de l’exécution, comme {0}, {1}, ou {name}. Si vous utilisez des espaces réservés dans vos ressources, vous devez vous assurer qu’ils sont cohérents dans toutes les localisations, sinon vous pourriez rencontrer des erreurs ou un comportement inattendu dans votre application.
Le nouvel Explorateur de ressources valide automatiquement les espaces réservés pour chaque ressource et affiche une icône d’avertissement s’il y a une incohérence entre la culture par défaut et toute autre localisation. Par exemple, si la valeur par défaut d’une ressource est « Hello, {name}! » et que la valeur en espagnol est « Hola, {nombre}! », vous verrez une icône d’avertissement indiquant que l’espace réservé est différent. Vous pouvez survoler l’icône pour voir une info-bulle avec les détails de l’incohérence et cliquer dessus pour la corriger.
Les traductions manquantes sont un autre problème courant qui peut affecter l’expérience utilisateur de votre application. Si vous ne fournissez pas de traduction pour une ressource dans une certaine culture, l’application reviendra à la culture par défaut, ce qui pourrait ne pas être approprié ou souhaitable pour certains utilisateurs. L’Explorateur de ressources vous aide à éviter ce problème en affichant une icône d’avertissement s’il n’y a pas de valeur pour une ressource dans une certaine culture. Par exemple, si> vous avez une ressource avec une valeur par défaut de File et aucune valeur pour la culture française, vous verrez une icône d’avertissement indiquant que la traduction est manquante. Vous pouvez survoler l’icône pour voir une info-bulle avec le message Aucune valeur et la sélectionner pour ajouter une valeur.
Options de personnalisation
L’Explorateur de ressources dans Visual Studio 2022 et versions ultérieures est compatible avec les lecteurs d’écran et la technologie d’assistance, afin de le rendre plus accessible pour les développeurs malvoyants ou handicapés. Vous pouvez utiliser des raccourcis clavier pour naviguer dans la grille de données, modifier les valeurs et les commentaires, et effectuer des actions courantes. Vous pouvez également utiliser le narrateur pour lire le contenu de chaque cellule, ainsi que les info-bulles et les avertissements.
Pour ajuster le niveau de zoom, utilisez le curseur de zoom dans la barre d’outils, ou les raccourcis clavier Ctrl+= et Ctrl+-, pour zoomer ou dézoomer. Utilisez Ctrl+0 pour réinitialiser le niveau de zoom à la valeur par défaut.
Le thème de l’Explorateur de ressources est cohérent avec le reste de l’environnement Visual Studio. Vous pouvez choisir entre les thèmes clair, sombre ou bleu, et l’Explorateur de ressources s’adaptera en conséquence. Vous pouvez également modifier la police et les couleurs de la grille de données, en utilisant la boîte de dialogue Outils>Options>Environnement>Polices et couleurs.
Ressources dans d’autres types de projets
Les ressources dans les projets .NET sont gérées différemment par rapport aux autres types de projets. Pour plus d’informations sur les ressources dans :
- Les applications Plateforme Windows universelle (UWP), consultez Ressources d’application et le système de gestion de ressources.
- Projets C++/CLI (gérés), consultez Ressources dans Applications de bureau
- Les projets C++, consultez Utiliser des fichiers de ressources et Guide pratique pour créer une ressource.
- Utilisez la fenêtre vue Ressource (Affichage>Autres fenêtres>Vue Ressource) pour afficher les fichiers de ressources inclus dans vos projets.
Options de support
Si vous rencontrez un problème de gestion des ressources d’application, consultez Résoudre les erreurs dans l’Éditeur de ressources.