Partager via

Vue d’ensemble de la localisation des métadonnées

  • Article

Certaines métadonnées définies à l’intérieur des objets de configuration prennent en charge la localisation. Les propriétés qui prennent en charge la localisation sont ornées LocalizableStringAttribute et le compilateur émet un avertissement si ces propriétés sont définies sur une valeur non localisable. Ces valeurs peuvent être localisées en incluant des fichiers string-resources.json avec votre extension et en entourant la clé de ressource de chaîne avec % des caractères.

Une Command avec un localisé DisplayName et ToolTipText ressemble à ce qui suit :

public override CommandConfiguration CommandConfiguration => new("%Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.DisplayName%")
{
    ToolTipText = "%Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.ToolTipText%"
}

string-resources.json

Votre extension doit fournir un fichier string-resources.json pour chaque langue prise en charge par votre extension. Ce fichier JSON est un dictionnaire de paires clé/valeur où la clé est un identificateur unique global (tous Visual Studio) pour une ressource de chaîne et la valeur est la ressource de chaîne localisée. Ces fichiers JSON doivent être déployés avec votre extension sous le .vsextension répertoire, chaque langue prise en charge étant fournie dans un dossier correspondant au nom des paramètres régionaux, c’est-à-dire « de » pour l’allemand, « it » pour l’italien, etc. Le fichier string-resources.json déployé à la racine du .vsextension répertoire est utilisé comme valeur par défaut si votre extension ne prend pas en charge la langue sur laquelle Visual Studio est actuellement défini. Voici un exemple de ce à quoi ressemble cette structure de répertoires :

Localization directory structure

exemple string-resources.json :

{
    "Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.DisplayName": "Sample Remote Command Display Name",
    "Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.ToolTipText": "Sample Remote Command ToolTip"
}

Étapes suivantes

En savoir plus sur les commandes VisualStudio.Extensibility à l’adresse Ajouter des commandes Visual Studio.