Localization
- 3 minutes to read
Localization is the process of translating a product into a different language. All DevExpress .NET products have localizable resources for UI elements such as dialog boxes, button captions, menu items and error messages. By localizing the application resources, you can provide an interface that is specific to a particular culture or locale.
This document demonstrates the most common approach to localizing a .NET application using Satellite Resource Assemblies (libraries that contain translated resources). This is the standard localization mechanism provided by the .NET Framework, appropriate for world-ready multi-language applications. To learn more about localization, refer to the Localizing Silverlight-based Applications topic in MSDN.
#Obtaining Satellite Assemblies
In most cases, you do not need to manually translate all language-specific resources, because DevExpress already delivers satellite assemblies for a large variety of languages and cultures.
Resource assemblies for some popular languages are provided by the .NET Products Installer. It registers these assemblies into the GAC (Global Assembly Cache) of your development machine, and also places them in the installation folder ("C:\Program Files (x86)\DevExpress 14.2\Components\Bin\Silverlight", by default).
This folder contains a subfolder with translated libraries. Each subfolder is named according to common culture abbreviations:
- de - German;
- es - Spanish;
- ja - Japanese;
- ru - Russian.
NOTE
For a full list of available culture names, refer to the National Language Support (NLS) API Reference topic in MSDN.
If these folders do not contain assemblies for the language you require, or you wish to provide custom translations for specific UI elements, you can use the DevExpress Localization Service. This service allows you to download and modify the satellite assemblies required to localize applications created with DevExpress .NET controls.
For more information on preparing and downloading resource assemblies, refer to the Localization Service documentation, or watch the training video on YouTube.
#Using Satellite Assemblies in Your Application
To use localized resources in your application, do the following.
Copy Silverlight satellite assemblies from the unpacked archive to the corresponding DevExpress Silverlight assembly folder. For instance, for the Italian language you should put localized assemblies into the following folder:
C:\Program Files (x86)\DevExpress 14.2\Components\Bin\Silverlight\it
- Create a build that targets a specific culture. For an example please see How to: Create a Build that Targets a Specific Culture in MSDN. The build will automatically include the resources of the default culture as specified in the main assembly, and the resources for the cultures that you designated in the .xap file.