Localization

By default all errors and information messages from XData modules use neutral (en-US) locale, but it's possible to translate this using satellite assembly (for .Net 4.0 version) or prepare resx files to Microsoft.Extension.Localization (for ASP.Net Core 2.0 projects used XData .Net Standard 2.0 version). To help developers make localization fast and simple as possible, XData sources complected with some "bat" files.

All settings within files is made for Russian locale (ru-RU), but there are no problem to patch files for any locale.

Prepare text files to translation

  1. Patch file add_locale.bat with setting path to RESGEN utility ("C:\Program Files\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools"), path to XData.dll and locale code.
  2. Run add_locale.bat and be sure with no errors during making translation file (.restext).
  3. Translate localization strings inside .restext file to target locale language. Take care, some string are multi-line, and some strings has format templates structure (see string.Format).

Satellite assembli compilation

(for .Net 4.0 version)

  1. Patch file compile.bat with setting path to AL utility ("C:\Program Files\Microsoft SDKs\Windows\v8.0A\bin\NETFX 4.0 Tools"), path to XData.dll and locale code.
  2. Run compile.bat and be sure and be sure with no errors during making satellite assembly (.dll).

Resource file generation

(for ASP.Net Core 2.0 projects used XData .Net Standard 2.0 version)

  1. Patch file createres.bat with setting path to RESGEN utility ("C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools"), path to XData.dll and locale code.
  2. Run createres.bat and be sure and be sure with no errors during making resource file (.resx).

Install sattelite assembly

  1. (for .Net 4.0 version) Copy localization folder named as target locale code to bin folder of Your application (where XData.dll is located) or (for ASP.Net Core 2.0 projects used XData .Net Standard 2.0 version) copy .resx file for target locale to resources folder of Your ASP.Net Core 2.0 site.
  2. Restart Your application or site.
Tip

Recommended materials:
https://msdn.microsoft.com/en-us/library/f45fce5x(v=vs.100).aspx
https://msdn.microsoft.com/en-us/library/ccec7sz1(v=vs.110).aspx
https://msdn.microsoft.com/en-us/library/sb6a8618(v=vs.100).aspx
http://www.codeproject.com/Articles/5447/NET-Localization-using-Resource-file