Utiliser des fichiers de ressources d’application (.resx) pour créer efficacement une application web ASP.NET localisable

Cet article explique comment utiliser le fichier de ressources pour créer une application web ASP.NET localisable que vous pouvez afficher en deux langues. La méthode décrite dans cet article utilise Microsoft Visual Studio pour remplir le fichier de ressources à l’aide de valeurs basées sur les propriétés de contrôle pour chaque page.

              Version d’origine du produit : ASP.NET
Numéro de la base de connaissances d’origine : 917414

Résumé

Vous pouvez utiliser des fichiers de ressources d’application (.resx) pour créer efficacement une application web Microsoft ASP.NET localisable. En utilisant des fichiers de ressources, vous pouvez stocker des valeurs localisées pour les contrôles. Les valeurs localisées sont basées sur la langue et la culture d’un utilisateur. Lorsque vous stockez des valeurs localisées dans des fichiers de ressources, ASP.NET pouvez sélectionner la valeur appropriée au moment de l’exécution.

Une application web ASP.NET localisable doit contenir les éléments suivants :

  • Un fichier de ressources (.resx) pour stocker les valeurs localisées
  • Codage pour associer des contrôles spécifiques à des valeurs localisées spécifiques

Cet article contient un exemple d’emplacement implicite qui utilise une combinaison de ressources de concepteur et de ressources d’éditeur pour produire un fichier de ressources.

Remarque

Il est préférable de générer les fichiers de ressources après avoir créé l’application web ASP.NET et après avoir ajouté des contrôles à la page.

Étape 1 : Préparer l’application

Pour préparer une nouvelle application web ASP.NET à utiliser des valeurs localisées, procédez comme suit :

  1. Créez une application web à l’aide de Visual Studio. Procédez comme suit :

    1. Démarrez Visual Studio.

    2. Dans le menu Fichier , sélectionnez Site web.

    3. Sélectionnez ASP.NET site web, sélectionnez Visual Basic dans la liste Langue, puis ok.

      Remarque

      Un site web est créé et le fichier Default.aspx s’affiche en mode Source.

    4. Pour basculer en mode Création, sélectionnez Création.

  2. Pour afficher du texte statique, ajoutez des contrôles à la page. Procédez comme suit :

    1. Dans la Boîte à outils, double-cliquez sur le contrôle Label pour ajouter un contrôle Label à la page.
    2. Sélectionnez Étiquette.
    3. Dans la fenêtre Propriétés , tapez Date dans la zone Texte .
    4. Dans la Boîte à outils, double-cliquez sur le contrôle Label pour ajouter un contrôle Label à la page.
    5. Organisez ce contrôle pour qu’il apparaisse sous l’étiquette Date .
    6. Sélectionnez Étiquette.
    7. Dans la fenêtre Propriétés , tapez Heure dans la zone Texte .
  3. Pour afficher du texte dynamique, ajoutez des contrôles à la page. Procédez comme suit :

    1. Dans la Boîte à outils, double-cliquez sur le contrôle Label pour ajouter un contrôle Label à la page.

    2. Organisez ce contrôle pour qu’il apparaisse à droite de l’étiquette Date .

    3. Dans la Boîte à outils, double-cliquez sur le contrôle Label pour ajouter un contrôle Label à la page.

    4. Organisez ce contrôle pour qu’il apparaisse à droite de l’étiquette Heure .

    5. Double-cliquez sur la page, puis ajoutez le code suivant à la Page_Load méthode .

       Label3.Text = Format(Now(), "H:mm")
       Label4.Text = Date.Now.Date
      

Étape 2 : Générer automatiquement les fichiers de ressources

Pour générer automatiquement les fichiers de ressources, procédez comme suit :

  1. Dans Explorateur de solutions, double-cliquez sur le fichier Default.aspx.

    Remarque

    Le fichier Default.aspx s’ouvre en mode Création.

  2. Dans le menu Outils , sélectionnez Générer des ressources locales.

    Remarque

    Par défaut, un nouveau dossier nommé App_LocalResources est créé. En outre, un fichier de ressources nommé Default.aspx.resx est créé. Ce fichier contient des informations sur chaque contrôle Label de la page. Les valeurs du fichier de ressources correspondent aux valeurs que vous avez entrées pour chaque contrôle Label en mode Création.

  3. Dans Explorateur de solutions, cliquez avec le bouton droit sur le fichier Default.aspx.resx, puis sélectionnez Copier.

  4. Dans Explorateur de solutions, cliquez avec le bouton droit sur le dossier App_LocalResources, puis sélectionnez Coller.

  5. Dans Explorateur de solutions, cliquez avec le bouton droit sur la copie du fichier Default.aspx.resx, puis sélectionnez Renommer.

  6. Tapez Default.aspx.es-mx.resx, puis appuyez sur Entrée.

    Remarque

    • Les étapes 3 à 6 créent un fichier de ressources localisé pour la langue espagnole. Vous pouvez créer un fichier de ressources localisé en incluant la langue et la culture entre .aspx et .resx dans le nom de fichier.
    • Pour modifier les valeurs localisées dans différents fichiers de ressources, ouvrez les fichiers de ressources dans Visual Studio, puis modifiez les propriétés de chaque contrôle localisé.

Étape 3 : Tester l’application

Pour tester l’application, procédez comme suit :

  1. Dans le menu Déboguer, sélectionnez Démarrer le débogage.

    Remarque

    Par défaut, Microsoft Internet Explorer démarre et le fichier Default.aspx de l’application web ASP.NET s’affiche.

  2. Dans le menu Outils d’Internet Explorer, sélectionnez Options Internet.

  3. Dans la boîte de dialogue Options Internet, sélectionnez l’onglet Général, puis langues.

  4. Dans la boîte de dialogue Préférences linguistiques, sélectionnez Ajouter.

  5. Dans la boîte de dialogue Ajouter une langue , sélectionnez Espagnol (Mexique) [es-mx], puis cliquez sur OK.

  6. Dans la boîte de dialogue Préférences linguistiques , sélectionnez Espagnol (Mexique) [es-mx], sélectionnez Monter, puis OK.

  7. Pour fermer la boîte de dialogue Options Internet , sélectionnez OK.

  8. Pour afficher le contenu localisé sur la page à l’aide des nouveaux paramètres de langue, sélectionnez Actualiser dans le menu Affichage .

References