Procédure pas à pas : Localisation d'une application métier

  • Article

Cette procédure pas à pas explique comment ajouter la prise en charge de la localisation à une application métier Services RIA WCF. De nos jours, beaucoup d'applications métier doivent être utilisées par des personnes se trouvant dans différentes parties du monde. Silverlight, ASP.NET et les Services RIA WCF incluent la prise en charge des applications localisées pour une culture ou des paramètres régionaux particuliers. Dans cette procédure pas à pas, vous allez écrire une application capable de charger des chaînes d'interface utilisateur écrites en anglais ou en français (Canada), en fonction de la valeur du paramètre de langue du navigateur.

RIA_Walkthrough_Loc_01

Cette procédure pas à pas décrit les tâches suivantes :

  • Configuration du projet client pour prendre en charge des langues spécifiques.

  • Ressources de localisation.

  • Configuration de la page de test pour utiliser des ressources localisées.

  • Configuration d'Internet Explorer pour charger une page localisée.

  • Ajout de la prise en charge des langues bidirectionnelles.

Configuration requise

Cette procédure pas à pas, ainsi que les autres procédures du même type présentées dans la documentation des Services RIA WCF, nécessite au préalable l'installation et la configuration correctes de plusieurs programmes, tels que Visual Studio 2010 et le Developer Runtime et SDK Silverlight, en plus des Services RIA WCF et du kit de ressources des Services RIA WCF. Ces procédures nécessitent également l'installation et la configuration de SQL Server 2008 R2 Express with Advanced Services et l'installation de la base de données AdventureWorks OLTP et LT.

Vous trouverez des instructions détaillées pour satisfaire chacune de ces conditions préalables dans les rubriques du nœud Conditions préalables pour les Services RIA WCF. Suivez ces instructions avant de poursuivre, pour être sûr de rencontrer le moins de problèmes possibles en effectuant ces procédures pas à pas des Services RIA .

Configuration du projet client

La procédure suivante indique comment spécifier les langues prises en charge dans le fichier du projet client.

Pour configurer le projet client

  1. Créez un projet Services RIA dans Visual Studio 2010 en sélectionnant Fichier, Nouveau, puis Projet.

    La boîte de dialogue Nouveau projet s'affiche.

  2. Sélectionnez le modèle Application métier Silverlight dans le groupe Silverlight des Modèles installés et nommez le nouveau projet LocalizedBusinessApp.

  3. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet client (LocalizedBusinessApp), puis cliquez sur Décharger le projet.

  4. Cliquez encore avec le bouton droit sur le projet client, puis cliquez sur Modifier LocalizedBusinessApp.vbproj ou Modifier LocalizedBusinessApp.csproj.

    RIA_LBA01_EditProject

    Le fichier de projet s'ouvre dans le concepteur.

  5. Trouvez l'élément SupportedCultures et ajoutez le code de culture de français (Canada) [fr-CA]. Utilisez une virgule ou un point-virgule pour délimiter les codes de culture.

    <SupportedCultures>en-US,fr-CA</SupportedCultures>

  6. Enregistrez et fermez le fichier de projet.

  7. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet client, puis cliquez sur Recharger le projet.

    Le projet est rechargé dans l'Explorateur de solutions.

Ressources de localisation.

L'ajout de la prise en charge par votre application d'une langue supplémentaire implique essentiellement de créer des copies des fichiers de ressources existants, de renommer les fichiers copiés, puis de traduire les chaînes dans les fichiers de ressources qui viennent d'être copiés. Les procédures suivantes indiquent comment localiser les ressources dans les projets client et serveur.

Pour localiser des ressources serveur

  1. Dans l'Explorateur de solutions, dans le projet serveur (LocalizedBusinessApp.Web), développez le dossier Resources.

  2. Cliquez avec le bouton droit sur le fichier RegistrationDataResources.resx, puis cliquez sur Copier.

  3. Cliquez avec le bouton droit sur le dossier Resources, puis cliquez sur Coller.

  4. Renommez Copie de RegistrationDataResources.resx en RegistrationDataResources.fr-CA.resx.

    noteRemarque :
    Le code de culture doit être inclus dans le nom du fichier pour établir correctement l'appartenance de la ressource à cette culture.

  5. De la même façon, copiez le fichier ValidationErrorResources.resx et renommez-le en ValidationErrorResources.fr-CA.resx.

    RIA_LBA03WebResources

  6. Double-cliquez sur RegistrationDataResources.fr-CA.resx pour l'ouvrir dans le Concepteur de ressources.

  7. Remplacez les valeurs et commentaires en anglais par les équivalents en français, comme indiqué dans le tableau suivant.

    Les chaînes de Commentaire sont utilisées généralement pour les info-bulles.

    Nom Valeur Commentaire

    EmailLabel

    Adresse de messagerie

    FriendlyNameDescription

    Comment voulez-vous que votre nom soit affiché dans l'application ?

    FriendlyNameLabel

    Nom convivial

    PasswordConfirmationLabel

    Confirmer le mot de passe

    PasswordDescription

    Le mot de passe doit être long de 7 caractères et doit contenir au moins un caractère spécial par exemple @ ou #

    Modifiez ceci si vous modifiez la longueur de votre mot de passe et les règles.

    PasswordLabel

    Mot de passe

    SecurityAnswerLabel

    Réponse de sécurité

    SecurityQuestionLabel

    Question de sécurité

    UserNameLabel

    Nom de l'utilisateur

  8. Enregistrez et fermez le fichier.

    TipConseil :
    Cette procédure pas à pas ne localise pas toutes les chaînes. Pour terminer la localisation des ressources serveur, vous devez également localiser ValidationErrorResources.fr-CA.resx.

  9. Dans le projet client, développez le dossier Web, puis développez Resources.

  10. Cliquez avec le bouton droit sur le dossier Resources, cliquez sur Ajouter, puis cliquez sur Élément existant.

  11. Accédez au dossier LocalizedBusinessApp.Web\Resources.

  12. Appuyez sur CTRL+clic pour sélectionner les fichiers suivants :

    • RegistrationDataResources.fr-CA.resx

    • RegistrationDataResources.fr-CA.Designer.vb (ou .cs)

    • ValidationErrorResources.fr-CA.resx

    • ValidationErrorResources.fr-CA.Designer.vb (ou .cs)

  13. Cliquez sur la flèche bas du bouton Ajouter, puis cliquez sur Ajouter en tant que lien.

    RIA_LBA04_AddingResxAsLink

    Les fichiers localisés sont ajoutés en tant que liens dans le projet client.

Pour localiser des ressources client

  1. Dans le projet client, développez le dossier Assets, puis développez Resources.

  2. Créez une copie d'ApplicationStrings.resx et renommez-la en ApplicationStrings.fr-CA.resx.

  3. Créez une copie d'ErrorResources.resx et renommez-la en ErrorResources.fr-CA.resx.

  4. Créez une copie de SecurityQuestions.resx et renommez-la en SecurityQuestions.fr-CA.resx.

    RIA_LBA05_ClientResources

  5. Ouvrez ApplicationStrings.fr-CA.resx dans le Concepteur de ressources.

  6. Remplacez les valeurs et les commentaires en anglais par les équivalents en français, comme suit :

    Nom Valeur Commentaire

    AboutPageTitle

    De

    		  

    AlreadyRegisteredLabel

    Déjà inscrit ?

    		  

    ApplicationName

    Nom d'application

    		  

    BackToLoginButton

    Retour à la connexion

    		  

    BusyIndicatorLoadingUser

    Initialisation de l'application en cours. ...

    Ce message s'affiche pendant l'initialisation de l'application

    BusyIndicatorLoggingIn

    Connexion en cours

    s'affiche pendant l'opération de connexion

    BusyIndicatorRegisteringUser

    Inscription en cours

    s'affiche pendant que l'inscription est traitée par le serveur

    CancelButton

    Annuler

    		  

    HomePageTitle

    Accueil

    		  

    LoginButton

    Connexion

    		  

    LoginWindowTitle

    Connexion

    		  

    LogOffButton

    Déconnexion

    		  

    NotRegisteredYetLabel

    Vous n'êtes pas encore inscrit ?

    		  

    OKButton

    OK

    		  

    RegisterNowButton

    S'inscrire maintenant

    		  

    RegistrationFormHeader

    Veuillez remplir tous les champs obligatoires pour créer votre compte

    		  

    RegistrationWindowTitle

    Inscription

    		  

    RememberMeLabel

    Me le rappeler ultérieurement

    		  

    WelcomeMessage

    Bienvenue, {0}

    {0} = propriété User.DisplayName

  7. Enregistrez et fermez le fichier.

    TipConseil :
    Pour terminer la localisation des ressources client, vous devez également localiser ErrorResources.fr-CA.resx et SecurityQuestions.fr-CA.resx.

Configuration de la page de test

La procédure suivante indique comment spécifier les informations de culture dans la page de test.

Pour configurer TestPage.aspx

  1. Dans le projet serveur, ouvrez LocalizedBusinessAppTestPage.aspx en mode Source.

  2. Dans l'élément racine, ajoutez les attributs Culture et UICulture qui ont la valeur "auto" :

    <%@ Page Language="VB" AutoEventWireup="true" UICulture="auto" Culture="auto" %>

    <%@ Page Language="C#" AutoEventWireup="true" UICulture="auto" Culture="auto" %>

  3. Enregistrez le fichier.

Configuration d'Internet Explorer

L'application cliente est maintenant prête à afficher l'une ou l'autre de ses deux versions différentes. Pour consulter la version Français (Canada), vous devez configurer votre navigateur Web pour qu'il utilise Français (Canada) comme langue par défaut. La procédure suivante explique comment configurer Internet Explorer.

Pour configurer Internet Explorer

  1. Appuyez sur F5 pour exécuter la solution.

    L'application démarre dans Internet Explorer. Sauf si la préférence de langue d'Internet Explorer est déjà définie sur français (Canada), les chaînes s'affichent en anglais.

  2. Cliquez sur le menu Outils, puis sur Options Internet.

    La boîte de dialogue Options Internet apparaît.

  3. Dans l'onglet Général, cliquez sur Langues.

    La boîte de dialogue Préférences de langue s'affiche.

  4. Cliquez sur Ajouter.

    La boîte de dialogue Ajouter une langue s'affiche.

    RIA_LBA06_IE_AddLanguageDialog

  5. Sélectionnez français (Canada) [fr-ca] puis cliquez sur OK.

  6. Dans la boîte de dialogue Préférences de langue, déplacez la langue français vers le sommet de la liste.

  7. Cliquez sur OK deux fois pour fermer les boîtes de dialogue.

  8. Actualisez la page.

    Les pages doivent maintenant s'afficher en français.

    LBA_fr-CA-Maison_homepage

  9. Cliquez sur le lien Connexion.

    Remarquez que la boîte de dialogue Connexion est en français.

Ajout de la prise en charge des langues bidirectionnelles.

Pour ajouter la prise en charge d'une langue bidirectionnelle à une application métier Silverlight, vous devez suivre les étapes précédentes, en remplaçant le code de paramètres régionaux utilisé par la langue bidirectionnelle de votre choix. De plus, vous devez spécifier le sens de déroulement, comme indiqué dans la procédure suivante.

Pour ajouter la prise en charge des langues bidirectionnelles.

  1. Dans chaque fichier de ressources qui contient des chaînes de langue bidirectionnelle, ajoutez une nouvelle ligne avec un Nom de FlowDirection et une Valeur de RightToLeft.

  2. Dans l'élément racine de chaque fenêtre XAML dans laquelle vous voulez implémenter la langue bidirectionnelle, ajoutez un attribut FlowDirection.

  3. Liez la valeur d'attribut FlowDirection à la valeur ajoutée au fichier de ressources, comme indiqué dans l'exemple suivant.

    FlowDirection="{Binding Path=ApplicationStrings.FlowDirection, Source={StaticResource ResourceWrapper}}"

Étapes suivantes

Voir aussi

Autres ressources

Localisation d'applications Silverlight
Globalisation et localisation ASP.NET