Share via

Panoramica della localizzazione dei metadati

  • Articolo

Alcuni metadati definiti all'interno degli oggetti di configurazione supportano la localizzazione. Le proprietà che supportano la localizzazione sono adornate con LocalizableStringAttribute e il compilatore genera un avviso se queste proprietà sono impostate su un valore non localizzabile. Questi valori possono essere localizzati includendo file string-resources.json con l'estensione e circondando la chiave di risorsa stringa con % caratteri.

Un Command oggetto con un oggetto localizzato DisplayName e ToolTipText ha un aspetto simile al seguente:

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

string-resources.json

L'estensione deve fornire un file string-resources.json per ogni linguaggio supportato dall'estensione. Questo file JSON è un dizionario di coppie chiave/valore in cui la chiave è un identificatore univoco globale (tutti di Visual Studio) per una risorsa stringa e il valore è la risorsa stringa localizzata. Questi file JSON devono essere distribuiti con l'estensione .vsextension nella directory, con ogni lingua supportata in una cartella corrispondente al nome delle impostazioni locali, ovvero "de" per il tedesco, "it" per l'italiano e così via. Il file string-resources.json distribuito nella radice della .vsextension directory viene usato come predefinito se l'estensione non supporta la lingua attualmente impostata su Visual Studio. Ecco un esempio dell'aspetto di questa struttura di directory:

Localization directory structure

Esempio string-resources.json:

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

Passaggi successivi

Altre informazioni sui comandi di VisualStudio.Extensibility sono disponibili in Aggiungere comandi di Visual Studio.