[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]Office File API
[Expand]Report and Dashboard Server
[Collapse]eXpressApp Framework
 [Expand]Getting Started
 [Expand]Design-Time Features
 [Collapse]Task-Based Help
  [Expand]Business Model Design
  [Expand]Application Model
  [Expand]List Editors
  [Expand]Property Editors
  [Expand]Scheduler and Notifications
    How to: Add a Custom Localization Dictionary to a Mobile Application
    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 (FAQ)
 [Expand]API Reference
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
This documentation page describes implementations made in our v17.2 release cycle. To learn about functionality shipping with v18.1, navigate to our updated help file experience at docs.devexpress.com. Learn More

How to: Localize an XAF Application

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

  1. To localize a Mobile application, add the Localization Mobile Module to your Mobile-oriented project.

  2. Choose a language you want to use in your XAF applications.

    One of the pre-installed languages: German (de), Spanish (es), Japanese (ja) and Russian (ru). Note that Spanish (es) is not provided for Mobile applications by default.

    Other languages:

    Satellite assemblies and localization dictionaries are reusable in any other project.


    Remember to deploy the required satellite assemblies when deploying an XAF application. Refer to the Deployment Tutorial for more details.

  3. 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.

  4. 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.

  5. To specify an application's language, 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. If you want your application's language to match the language on the user's device (or browser language for Mobile applications), set the PreferredLanguage property to (User language).

  6. 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.

  7. The splash screen form displayed on the Windows Forms application startup contains a "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.

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

Expanded See Also

Is this topic helpful?​​​​​​​