Comment : localiser du codeHow to: Localize code

Le code non localisé utilise des valeurs de chaîne codées en dur.Unlocalized code uses hard-coded string values. Pour localiser des chaînes de code, remplacez-les par des appels à GetGlobalResourceObject , qui est une méthode qui fait référence aux ressources localisées.To localize code strings, replace them with calls to GetGlobalResourceObject, which is a method that references localized resources.

Localiser du codeLocalize code

Pour localiser du codeTo localize code

  1. Dans Explorateur de solutions, ouvrez le menu contextuel d’un élément de projet, puis choisissez Ajouter un > module.In Solution Explorer, open the shortcut menu for a project item, and then choose Add > Module.

    Choisissez le modèle de fichier de ressources .Choose the Resources File template.

    Notes

    Veillez à ajouter le fichier de ressources à un élément de projet SharePoint afin que la propriété type de déploiement soit disponible.Be sure to add the resource file to a SharePoint project item so that the Deployment Type property is available. Cette propriété est requise plus loin dans cette procédure.This property is required later in this procedure.

  2. Donnez au fichier de ressources de langue par défaut le nom de votre choix, ajouté avec une extension . resx , par exemple MyAppResources. resx.Give the default language resource file a name of your choice appended with a .resx extension, such as MyAppResources.resx.

  3. Répétez les étapes 1 et 2 pour ajouter des fichiers de ressources distincts à l’élément de projet SharePoint : un pour chaque langue localisée.Repeat steps 1 and 2 to add separate resource files to the SharePoint project item: one for each localized language.

    Utilisez le même nom de base pour chaque fichier de ressources localisé, mais ajoutez l’ID de culture.Use the same base name for each localized resource file, but add the culture ID. Par exemple, nommez une ressource localisée allemande MyAppResources.de-de. resx.For example, name a German localized resource MyAppResources.de-DE.resx.

  4. Ouvrez chaque fichier de ressources et ajoutez des chaînes localisées.Open each resource file and add localized strings. Utilisez les mêmes ID de chaîne dans chaque fichier.Use the same string IDs in each file.

  5. Modifiez la valeur de la propriété type de déploiement de chaque fichier de ressources en AppGlobalResource de façon à ce que chaque fichier soit déployé dans le dossier App_GlobalResources du serveur.Change the value of the Deployment Type property of each resource file to AppGlobalResource to cause each file to deploy to the server's App_GlobalResources folder.

  6. Laissez la valeur de la propriété action de génération de chaque fichier en tant que ressource incorporée.Leave the value of the Build Action property of each file as Embedded Resource.

    Les ressources incorporées sont compilées dans la DLL du projet.Embedded resources are compiled into the project's DLL.

  7. Générez le projet pour créer les dll satellites des ressources.Build the project to create the resource satellite DLLs.

  8. Dans le Concepteur de packages, choisissez l’onglet avancé , puis ajoutez l’assembly satellite.In the Package Designer, choose the Advanced tab, and then add the satellite assembly.

  9. Dans la zone emplacement , ajoutez un dossier de l’ID de culture au chemin d’accès de l’emplacement, par exemple de-de \ <Project Item Name>.resources.dll.In the Location box, prepend a culture ID folder to the Location path, such as de-DE\<Project Item Name>.resources.dll.

  10. Si votre solution ne fait pas déjà référence à l’assembly System. Web, ajoutez une référence à celui-ci et ajoutez une directive dans votre code à System.Web .If your solution does not already reference the System.Web assembly, add a reference to it, and add a directive in your code to System.Web.

  11. Recherchez toutes les chaînes codées en dur dans votre code qui sont visibles par les utilisateurs, telles que le texte de l’interface utilisateur, les erreurs et le texte du message.Locate all hard-coded strings in your code that are visible to users, such as UI text, errors, and message text. Remplacez-les par un appel à la GetGlobalResourceObject méthode à l’aide de la syntaxe suivante :Replace them with a call to the GetGlobalResourceObject method using the following syntax:

    HttpContext.GetGlobalResourceObject("Resource File Name", "String ID")
    
  12. Appuyez sur la touche F5 pour générer et exécuter l’application.Choose the F5 key to build and run the application.

  13. Dans SharePoint, modifiez la langue d’affichage par défaut.In SharePoint, change the display language from the default.

    Les chaînes localisées s’affichent dans l’application.The localized strings appear in the application. Pour afficher les ressources localisées, le serveur SharePoint doit disposer d’un module linguistique qui correspond à la culture du fichier de ressources.To display localized resources, the SharePoint server must have a language pack installed that matches the resource file's culture.

Voir aussiSee also