.Net Resource (.resx)
RESX (Resource XML) ist das Lokalisierungsformat für die .NET-Plattform und unterstützt ASP.NET Core, WPF, WinForms und Blazor. Die Basisressourcendatei (Resources.resx) enthält Standardsprachenzeichenketten. Sprachspezifische Überschreibungen werden in separaten Dateien gespeichert: Resources.fr.resx, Resources.de.resx usw. Der .NET-Ressourcen-Manager wählt zur Laufzeit die korrekte Datei basierend auf der aktuellen Kultur des Threads und greift durch die Satellite-Assembly-Kette zurück.
RESX ist eine XML-Datei, in der jede Zeichenkette ein data-Element mit einem name-Attribut (dem Schlüssel) und einem value-Kindelement ist. Ein comment-Element speichert Übersetzernotizen. Die Basis-RESX wird in die Hauptassembly kompiliert; sprachspezifische Dateien werden in Satellite-Assemblys in kulturbenannten Unterverzeichnissen kompiliert. Der EmbeddedResource-Elementtyp von MSBuild steuert die Kompilierung. Aus RESX generierte Designer.cs-Dateien stellen Schlüssel als typisierte Eigenschaften für Kompilierungssicherheit bereit.
Best Practice: Organisieren Sie RESX-Dateien nach Funktionsbereich – Auth.resx, Checkout.resx, Common.resx – und verwenden Sie IStringLocalizer mit typisierten generischen Parametern in ASP.NET Core für Compile-Time-Satellite-Assembly-Bindung. Benennen Sie Schlüssel in PascalCase und vermeiden Sie Leerzeichen oder Bindestriche, die die Designer.cs-Eigenschaftsgenerierung unterbrechen. Dokumentieren Sie den Typ und Zweck jedes positionellen Formatarguments im Ressourcenkommentar. Language Monster erkennt RESX-Dateien automatisch, bewahrt XML-Struktur und Kommentarknoten, schützt .NET-Formatbezeichner während der Übersetzung und überträgt fertige Satellite-Dateien zurück in Ihr Repository.