Freigeben über

Übersicht über die Metadatenlokalisierung

  • Artikel

Einige metadaten, die innerhalb von Konfigurationsobjekten definiert sind, unterstützen die Lokalisierung. Eigenschaften, die die Lokalisierung unterstützen, werden mit LocalizableStringAttribute versehen, und der Compiler gibt eine Warnung aus, wenn diese Eigenschaften auf einen nicht lokalisierbaren Wert festgelegt sind. Diese Werte können lokalisiert werden, indem sie Zeichenfolgenressourcen.json-Dateien mit Ihrer Erweiterung einschließen und den Zeichenfolgenressourcenschlüssel mit % Zeichen umgibt.

A Command mit lokalisiertem DisplayName Und ToolTipText sieht wie folgt aus:

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

string-resources.json

Ihre Erweiterung sollte eine Datei "string-resources.json " für jede Sprache bereitstellen, die Ihre Erweiterung unterstützt. Diese JSON-Datei ist ein Wörterbuch mit Schlüssel-Wert-Paaren, bei denen der Schlüssel ein eindeutiger Bezeichner (alle Visual Studio) für eine Zeichenfolgenressource ist und der Wert die lokalisierte Zeichenfolgenressource ist. Diese JSON-Dateien sollten mit Ihrer Erweiterung unter dem .vsextension Verzeichnis bereitgestellt werden, wobei jede Sprache, die Sie unterstützen, in einem Ordner mit dem Namen des Gebietsschemas ausgeliefert wird, d. h. "de" für Deutsch, "it" für Italienisch usw. Die im Stammverzeichnis des .vsextension Verzeichnisses bereitgestellte Zeichenfolgenressourcen.json wird als Standard verwendet, wenn Ihre Erweiterung die Aktuell festgelegte Sprache von Visual Studio nicht unterstützt. Ein Beispiel dafür, wie diese Verzeichnisstruktur aussehen würde, finden Sie hier:

Localization directory structure

string-resources.json-Beispiel:

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

Nächste Schritte

Weitere Informationen zu VisualStudio.Extensibility-Befehlen finden Sie unter "Visual Studio-Befehle hinzufügen".