Log In
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Collapse]eXpressApp Framework
 [Expand]Getting Started
 [Expand]Design-Time Features
 [Expand]Functional Testing
 [Collapse]Task-Based Help
  [Expand]Business Model Design
  [Expand]Application Model
  [Expand]List Editors
  [Expand]Property Editors
  [Expand]Scheduler and Notifications
    How to: Change a Mobile UI Language at Runtime
    How to: Create a Custom Translation Provider for the Localization Tool
    How to: Localize a WinForms Template
    How to: Localize an XAF Application
    How to: Localize Custom String Constants
    How to: Localize XAF Application Items Using XAF Tools
  [Expand]Miscellaneous UI Customizations
  Frequently Asked Questions
 [Expand]API Reference
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

How to: Localize an XAF Application

This topic describes how to localize a whole XAF application. We recommend reviewing the Application Model Basics and Localization Basics topics before proceeding.


If you want to localize a Mobile application, add the Localization Mobile Module to your Mobile-oriented project.

  1. XAF provides satellite assemblies with translated standard XAF Modules and DevExpress controls in several languages: de, es, ja and ru. These assemblies are installed in %PROGRAMFILES(x86)%\DevExpress 17.2\Components\Bin and GAC by default. If you want to use one of these predefined languages, refer to step 2.

    You can download satellite assemblies for other languages using the Localization Service. After you download these assemblies, register them in the GAC. Refer to the Localize Standard XAF Modules and DevExpress Controls Used in an Application topic for more details on how to localize XAF modules in a localization service.

    These localized resources are reusable - you can use them in all your projects.

  2. In the module project, double-click the Model.DesignedDiffs.xafml file to invoke the Model Editor. Focus the root node and click Languages Manager... in the Language combo box on the Model Editor Toolbar. Add the target language in the invoked dialog and click OK. Restart Visual Studio to load localized values from the satellite assemblies and specify the application's target language in the Language combo box.

    Refer to the Localization Basics topic for more information.

  3. To add a new or modify an existing translation value, use one of the tools described in the How to: Localize XAF Application Items Using XAF Tools topic.

  4. To specify the language you want to use in an application, invoke the Model Editor for an application project, navigate to the Application node and set the IModelApplication.PreferredLanguage property to the required language. Refer to the Localization Basics topic for more details. .

  5. Windows Forms Templates' localizable resources are not available in the Application Model by default. Refer to the How to: Localize a WinForms Template to learn how you can localize it.

  6. The splash screen form displayed on the Windows Forms application startup contains the "Loading" text label. You can specify a different text as described in the How to: Use a Custom Splash Screen topic's Splash Screen Localization section.

  7. Start the application to ensure that all the text values are localized.

Expanded See Also

How would you rate this topic?​​​​​​​