Partager via


Comment : utiliser des ressources pour définir des valeurs de propriété dans des contrôles serveur Web (Visual Studio)

Mise à jour : novembre 2007

Dans une page ASP.NET, vous pouvez utiliser les méthodes suivantes pour lire des valeurs dans des fichiers de ressources :

  • Localisation implicite   ASP.NET remplit des valeurs de propriétés à partir d'un fichier de ressources local en fonction de clés correspondant aux propriétés. En utilisant un outil de Visual Web Developer, vous pouvez marquer automatiquement tous les contrôles d'une page pour leur localisation implicite.

  • Localisation explicite   Créez une expression qui lit une ressource spécifique depuis un fichier de ressources local ou global. Vous devez créer des expressions pour chaque propriété du contrôle que vous souhaitez définir à l'aide d'une ressource.

Vous pouvez également lire par programme des valeurs de fichiers de ressources. Pour plus d'informations, consultez Comment : récupérer des valeurs de ressources par programme. 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).

Pour utiliser la localisation implicite

  1. Ouvrez la page pour laquelle vous souhaitez créer des fichiers de ressources.

  2. Basculez en mode Design.

  3. 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 pour la page actuelle, qui inclut une paire clé/nom pour chaque contrôle localisable de chaque contrôle serveur Web ASP.NET de la page. 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.

    Remarque :

    Vous pouvez également ajouter manuellement l'attribut meta en mode Source. Pour plus d'informations, consultez Comment : utiliser des ressources pour définir des valeurs de propriété dans des contrôles serveur Web (Visual Studio).

Pour utiliser la localisation explicite avec des expressions de ressource

  1. En mode Design, sélectionnez le contrôle pour lequel vous souhaitez utiliser des expressions de ressource.

  2. Dans la catégorie Données de la fenêtre Propriétés, cliquez sur (Expressions) et, puis sur le bouton de sélection.

  3. Dans la boîte de dialogue Expressions, sous Propriétés pouvant être liées, sélectionnez la propriété que vous souhaitez définir à l'aide d'une ressource.

  4. Dans la liste Type d'expression, cliquez sur Ressources.

  5. Si vous utilisez des ressources globales, entrez le nom de classe du fichier de ressources que vous souhaitez utiliser dans la zone ClassKey.

    Remarque :

    Le nom de classe est tiré de celui du fichier .resx. Un fichier de ressources nommé WebResources.resx utilise le nom de classe WebResources. Tous les fichiers de ressources utilisent le même nom de classe dans toutes les langues. Si vous souhaitez obtenir une ressource du fichier de ressources local associé à la page actuelle, cette valeur est facultative.

  6. Dans la zone ResourceKey, entrez le nom de la ressource que vous souhaitez utiliser. Si vous utilisez le fichier de ressources local de la page actuelle, vous pouvez cliquer sur la flèche de déroulement pour voir une liste des ressources disponibles dans le fichier.

  7. Répétez les étapes 3 à 6 pour chaque propriété que vous souhaitez définir dans le contrôle actuel, puis cliquez sur OK.

  8. Répétez les étapes 1 à 8 pour chaque contrôle pour lequel vous souhaitez utiliser des ressources.

Voir aussi

Tâches

Procédure pas à pas : utilisation de ressources pour la localisation avec ASP.NET

Comment : récupérer des valeurs de ressources par programme

Concepts

Vue d'ensemble des ressources des pages Web ASP.NET