Partager via


Comment : localiser le balisage ASPX

Les pages ASP.NET (.aspx) utilisent généralement des valeurs de chaîne codées en dur.Pour localiser ces chaînes, remplacez-les par des expressions qui référencent des ressources localisées.

Localisation du balisage ASPX

Pour localiser le balisage ASPX

  1. Ajoutez des fichiers de ressources séparés : un pour la langue par défaut et un pour chaque langue localisée.

    Si vous localisez le balisage uniquement et pas le code, ajoutez un élément de projet Fichier de ressources global.Si vous localisez le code et le balisage, ajoutez un élément de projet Fichier de ressources.

    1. Pour ajouter un fichier de ressources global, dans Explorateur de solutions, ouvrez le menu contextuel pour un élément de projet SharePoint, puis choisissez Ajouter, Nouvel élément.Sous le nœud 2010 SharePoint, choisissez le modèle Fichier de ressources global .

    2. Pour ajouter un fichier de ressources, dans Explorateur de solutions, ouvrez le menu contextuel pour un élément de projet SharePoint, puis choisissez Ajouter, Nouvel élément.Sous Visual Basic ou le nœud Visual C# , choisissez le modèle fichier de ressources .

    [!REMARQUE]

    Veillez à ajouter les fichiers de ressources à un élément de projet SharePoint pour activer la propriété Type de déploiement.Cette propriété est requise plus loin dans cette procédure.Si votre solution ne contient pas d'élément de projet SharePoint, vous pouvez ajouter un projet SharePoint vide et supprimer son fichier Elements.xml par défaut.

  2. Attribuez au fichier de ressources de langue par défaut le nom de votre choix, avec l'extension .resx, par exemple MyAppResources.resx.Utilisez le même nom de base pour chaque fichier de ressources localisé, mais ajoutez l'ID de culture. Par exemple, nommez une ressource localisée en allemand MyAppResources.de-DE.resx.

  3. Remplacez la valeur de la propriété Type de déploiement de chaque fichier de ressources par AppGlobalResource pour les rendre déployer vers le dossier App_GlobalResources du serveur.

  4. Si vous utilisez les ressources pour localiser le code en plus de le balisage ASPX, conservez la valeur de la propriété Action de génération de chaque fichier sous Ressource incorporée.Si vous utilisez uniquement les fichiers de ressources pour localiser le balisage, vous pouvez éventuellement remplacer la valeur de propriété des fichiers par Contenu.Pour plus d'informations, consultez Localisation de solutions SharePoint.

  5. Ouvrez chaque fichier de ressources et ajoutez des chaînes localisées, en utilisant les mêmes ID de chaîne dans chacun des fichiers.

  6. Dans le balisage XML pour le contrôle ou la page ASPX, remplacez les chaînes codées en dur par des valeurs au format suivant :

    <%$Resources:Resource File Name, String ID%>
    

    Par exemple, pour localiser le texte d'un contrôle label dans une page d'application, il vous faudrait changer :

    <asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
    <asp:Label ID="lbl" runat="server" Text="Label text"></asp:Label>
    </asp:Content>
    

    en

    <asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
    <asp:Label ID="lbl" runat="server" Text="<%$Resources:MyAppResources,String1%>"></asp:Label>
    </asp:Content>
    
  7. Choisissez la touche F5 pour générer et exécuter l'application.

  8. Dans SharePoint, modifiez la langue d'affichage par défaut.

    Les chaînes localisées s'affichent dans l'application.Pour afficher les ressources localisées, un module linguistique qui correspond à la culture du fichier de ressources doit être installé sur le serveur SharePoint.

Voir aussi

Tâches

Comment : localiser une fonctionnalité

Comment : ajouter un fichier de ressources

Comment : localiser du code

Concepts

Localisation de solutions SharePoint