Comment : créer des fichiers de ressources pour des sites Web ASP.NET (Visual Studio)
Mise à jour : novembre 2007
Un fichier de ressources est un fichier XML qui peut contenir des chaînes et d'autres ressources, telles que des chemins d'accès de fichiers images. Les fichiers de ressources sont en général utilisés pour stocker des chaînes d'interface utilisateur qui doivent être traduites dans d'autres langues. La raison en est que vous pouvez créer un fichier de ressources distinct pour chacune des langues dans laquelle vous souhaitez traduire une page Web.
Les fichiers de ressources globaux sont disponibles pour toutes les pages ou tous les composants de votre site Web. Les fichiers de ressources locaux sont associés à une page Web seule, un contrôle utilisateur ou une page maître et contiennent les ressources ne concernant que cette page. Pour plus d'informations, consultez Vue d'ensemble des ressources des pages Web ASP.NET.
Dans Visual Web Developer, vous pouvez utiliser l'éditeur de ressources managées pour créer des fichiers de ressources globaux ou locaux. Pour les fichiers de ressources locaux, vous pouvez également générer un fichier de ressources de base culturellement neutre directement à partir d'une page Web dans le concepteur.
Création manuelle de ressources
Pour créer un fichier de ressources manuellement
Assurez-vous que votre site Web possède un dossier dans lequel stocker le fichier de ressources à l'aide de l'une des actions suivantes :
Si vous créez un fichier de ressources global, vous devez disposer d'un dossier nommé App_GlobalResources. Pour créer le dossier, dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom de votre site Web, cliquez sur Ajouter un dossier, puis sur Dossier App_GlobalResources. Il ne peut y avoir qu'un seul de ces dossiers dans une application et il doit être placé à la racine de l'application.
Si vous créez un fichier de ressources local, vous devez disposer d'un dossier nommé App_LocalResources. Pour créer le dossier, dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom de votre site Web, cliquez sur Ajouter un dossier, puis sur Dossier App_LocalResources. Une application peut contenir un grand nombre de ces dossiers, qui peuvent être placés à n'importe quel niveau de l'application.
Pour créer un fichier de ressources, cliquez avec le bouton droit sur le dossier App_GlobalResources ou App_LocalResources, puis cliquez sur Ajouter un nouvel élément.
.gif "Remarque")
Remarque :Les fichiers de ressources globaux doivent se trouver dans le dossier App_GlobalResources. Si vous essayez de créer un fichier .resx en dehors de ce dossier, Visual Web Developer vous invite à le créer dans le dossier.
Dans la boîte de dialogue Ajouter un nouvel élément, sous Modèles Visual Studio installés, cliquez sur Fichier de ressources de l'assembly.
Dans la zone Nom, entrez un nom pour votre fichier de ressources et cliquez sur Ajouter.
Visual Web Developer ouvre le fichier dans l'Éditeur de ressources managées. L'éditeur affiche une grille dans laquelle vous pouvez saisir des noms (clés), des valeurs et des commentaires facultatifs.
Entrez les noms clés et les valeurs de chaque ressource dont vous avez besoin dans votre application, puis enregistrez le fichier.
Remarque :N'essayez pas d'incorporer directement un graphique dans un fichier de ressources car les contrôles ne liront pas la chaîne de ressources comme un fichier image transmis en continu. Les fichiers de ressources peuvent représenter un graphique en stockant l'URL du graphique sous forme de chaîne.
Pour créer des fichiers de ressources pour des langues supplémentaires, copiez le fichier dans l'Explorateur de solutions ou dans l'Explorateur Windows, puis renommez-le d'après l'un des schémas suivants :
Pour les fichiers de ressources globaux :
name.language.resx
name.language-culture.resx
Pour les fichiers de ressources locaux :
pageOrControlName.extension.language.resx
pageOrControlName.extension.language-culture.resx
Par exemple, si vous créez un fichier de ressources global nommé WebResources.resx pour la traduction en arabe égyptien, nommez le fichier copié WebResources.ar-eg.resx. Pour créer un fichier de ressources associé pour la traduction en espagnol sans spécifier de culture, nommez le fichier copié WebResources.es.resx. Notez que pour les fichiers de ressources locaux, le nom du fichier de ressources est le nom de la page ou du contrôle, y compris l'extension de nom de fichier, suivi des informations de langue et de culture.
Ouvrez le fichier copié et traduisez chaque valeur, sans modifier les noms (clés).
Répétez les étapes 6 et 7 pour chaque langue supplémentaire que vous souhaitez utiliser.
Création de ressources à partir d'une page Web
Cette fonctionnalité n'est pas disponible dans Visual Web Developer Express.
Pour générer un fichier de ressources local à partir d'une page Web ASP.NET
Ouvrez la page pour laquelle vous souhaitez créer un fichier de ressources.
Basculez en mode Design.
Dans le menu Outils, cliquez sur Générer la ressource locale.
Visual Web Developer crée le dossier App_LocalResources s'il n'existe pas déjà. Visual Web Developer crée ensuite le fichier de ressources de base culturellement neutre pour la page actuelle, qui inclut une paire clé/nom pour chaque propriété du contrôle ou de page devant être localisée. Enfin, Visual Web Developer ajoute un attribut meta à chaque contrôle serveur Web ASP.NET pour configurer ce dernier de manière à ce qu'il utilise la localisation implicite. Pour plus d'informations sur la localisation implicite et explicite, consultez Vue d'ensemble des ressources des pages Web ASP.NET et Comment : utiliser des ressources pour définir des valeurs de propriété dans des contrôles serveur Web (Visual Studio).
Entrez les valeurs de chacune des ressources dont vous avez besoin dans votre application, puis enregistrez le fichier.
Remarque :N'essayez pas d'incorporer directement un graphique dans un fichier de ressources car les contrôles ne liront pas la chaîne de ressources comme un fichier image transmis en continu. Les fichiers de ressources peuvent représenter un graphique en stockant l'URL du graphique sous forme de chaîne.
Si les modifications de ressource les plus récentes ne sont pas affichées, actualisez le mode Design en basculant en mode Source, puis en revenant au mode Design.
Créez des fichiers de ressources pour les langues supplémentaires en suivant les étapes 6 et 7 de la procédure précédente.
Pour générer un fichier de ressources global dans Visual Web Developer
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du site Web, cliquez sur Ajouter un nouvel élément, puis sur Fichier de ressources.
Visual Web Developer vous demande si vous souhaitez placer le fichier dans le dossier App_GlobalResources et propose de créer le dossier.
Cliquez sur Oui.
Entrez les valeurs de chacune des ressources dont vous avez besoin dans votre application, puis enregistrez le fichier.
Remarque :N'essayez pas d'incorporer directement un graphique dans un fichier de ressources car les contrôles ne liront pas la chaîne de ressources comme un fichier image transmis en continu. Les fichiers de ressources peuvent représenter un graphique en stockant l'URL du graphique sous forme de chaîne.
Si les modifications de ressource les plus récentes ne sont pas affichées, actualisez le mode Design en basculant en mode Source, puis en revenant au mode Design.
Pour créer des fichiers de ressources pour des langues supplémentaires, copiez le fichier dans l'Explorateur de solutions ou dans l'Explorateur Windows, puis renommez-le d'après l'un des schémas suivants :
name.language.resx
name.language-culture.resx
Remarque :Lorsque vous nommez des fichiers de ressources, n'incluez pas .aspx dans le nom, car cela pourrait entraîner un conflit de nom. Le dossier Resource ne peut pas contenir deux fichiers nommés resTestPage.resx et resTestPage.aspx.resx par exemple. Dans ce cas, la résolution des noms de fichiers au moment de la compilation créerait un conflit de nom, ce qui entraînerait une erreur de compilation.
Voir aussi
Tâches
Procédure pas à pas : utilisation de ressources pour la localisation avec ASP.NET