ActiveReports uses the Hub and Spoke model for localizing resources. The hub is the main executing assembly and the spokes are the satellite DLLs that contain localized resources for the application.

For example, if you want to localize the Viewer Control, the hub is MESCIUS.ActiveReports.Viewer.Win.dll and the spoke is MESCIUS.ActiveReports.Viewer.Win.resources.dll.

In your Program Files folder, the Localization folder is in a path like ....\MESCIUS\ActiveReports 18\Localization, and contains all of the ActiveReports components that you can localize.

The Localization folder contains ActiveReports components and most have two files.

• A .bat file that is used to set the Cultures to which you want to localize.
• A .zip file that contains the resource files (.resx) in which you update or change the strings.

There is one application in the Localization folder: NameCompleter.exe. When you run your .bat file after updating your culture, it runs this application to create a SatelliteAssembly folder with a language sub-folder containing the localized MESCIUS.ActiveReports.AssemblyName.resources.dll file.

Place the language folder containing the *.resources.dll file inside your main executing assembly folder to implement changes.

When the main executing assembly needs a resource, it uses a ResourceManager object to load the required resource. The ResourceManager uses the thread's CurrentUICulture property.

The common language run time sets the CurrentUICulture property or you can set it in code to force a certain UI Culture so that you can test whether your satellite DLL is loading properly. The ResourceManager class uses the CurrentUICulture property to locate subdirectories that contain a satellite DLL for the current culture. If no subdirectory exists, the ResourceManager uses the resource that is embedded in the assembly. US English ("en-US") is the default culture for ActiveReports.