Global Resources
- 4 minutes to read
This topic describes the native ASP.NET localization technique and contains download links to localized resources for DevExpress ASP.NET components.
Tip
In v12.1 and higher, we recommend that you localize your application with the Satellite Resource Assemblies. This technique is more modern and allows you to get the most recent string translations.
You can download default and translated resources from the following link:
Note that the downloaded file contains translations that are relevant as of June 24, 2022. These translations were generated by the DevExpress developer community. You should verify accuracy before incorporating resources into your software project.
Resource Files
A resource file is an XML file that contains strings that can be translated into different languages. Resource files in ASP.NET have a .resx extension. Each localized resource file contains name/value pairs. You can use a text editor to customize a resource file’s string values.
Refer to the following topic in the Visual Studio documentation to learn more about global resource files: ASP.NET Web Page Resources Overview.
DevExpress ASP.NET products ship with a default resource file and numerous localized resource files (one for each culture).
Product | Default Resource File |
|---|---|
DevExpress_Web_ASPxGridView_v24.1.resx | |
DevExpress_Web_v24.1.resx | |
DevExpress_Web_ASPxEditors_v24.1.resx | |
DevExpress_Web_ASPxDiagram_v24.1.resx | |
DevExpress_Web_v24.1.resx | |
DevExpress_Web_ASPxGantt_v24.1.resx | |
DevExpress_Web_ASPxGridView_v24.1.resx | |
DevExpress_Web_v24.1.resx | |
DevExpress_Web_ASPxHtmlEditor_v24.1.resx | |
DevExpress_Web_v24.1.resx | |
DevExpress_Web_ASPxPivotGrid_v24.1.resx | |
DevExpress_XtraReports_v24.1_Web.resx | |
DevExpress_Web_ASPxRichEdit_v24.1.resx | |
DevExpress_Web_ASPxScheduler_v24.1.resx | |
DevExpress_Web_v24.1.resx | |
DevExpress_Web_ASPxSpellChecker_v24.1.resx | |
DevExpress_Web_ASPxSpreadsheet_v24.1.resx | |
DevExpress_Web_ASPxTreeList_v24.1.resx | |
DevExpress_Web_ASPxGridView_v24.1.resx |
A localized resource file name consists of the corresponding default name and a culture name, such as the following:
- DevExpress_Web_v24.1.resx - the default resource file for DevExpress ASP.NET components.
- DevExpress_Web_v24.1.de.resx - a resource file for the German localization of DevExpress ASP.NET components.
Chinese (Simplified) [zh-CHS] (prior v12.1 - see “zh-Hans” vs “zh-CHS” and “zh-Hant” vs “zh-CHT”)
Chinese [zh-Hans] v12.1+
Chinese [zh-Hant] v12.1+
Croatian [hr]
Czech [cs]
Danish [da]
French [fr]
German [de]
Greek [el]
Hungarian [hu]
Italian [it]
Polish [pl]
Portuguese (Brazil) [pt-BR]
Portuguese (Portugal) [pt-PT]
Romanian [ro]
Russian [ru]
Slovak [sk] v12.1+
Slovenian [sl]
Spanish [es]
Swedish [sv] v11.2+
Turkish [tr] v14.2+
Dutch - The Netherlands [nl]
Norwegian [no]
Japanese [ja] v11.1+
Add Global Resources to an Application
Copy localized and corresponding default resource files to the App_GlobalResources folder.
Note that if the App_GlobalResources folder contains only a localized resource file (DevExpress_Web_v24.1.de.resx), without the corresponding default resource file (DevExpress_Web_v24.1.resx), an exception will occur.
Set an Application Culture
An application culture is defined by the Culture and UICulture properties. You can specify them in the following ways.
Localize an Application for a Specific Culture (regardless of operating system settings)
Set the Culture and UICulture properties to a certain culture ID. You can specify the properties at design time or runtime.
Design Time
Add the globalization element to the Web.config file. Set the Culture and uiCulture attributes.
<system.web>
<globalization uiCulture="es" culture="es" />
...
</system.web>
Runtime
To switch a culture at runtime, specify the CurrentUICulture and CurrentCulture properties. One of the ways to adjust these properties across the entire application is handling the HttpApplication.AcquireRequestState event in the Global.asax file.
protected void Application_AcquireRequestState(object sender, EventArgs e) {
CultureInfo ci = new CultureInfo("de-DE");
Thread.CurrentThread.CurrentUICulture = ci;
Thread.CurrentThread.CurrentCulture = ci;
}
See also: How to change the current culture at runtime
Create Culture-Independent Settings in an Application
You can specify culture-independent settings in your application. For instance, always show currency in euros. To change settings without changing the current culture, follow the steps below:
- Clone current
CultureInfo. - Change settings of the new
CultureInfoobject. Note that it is possible to copy settings from another culture instead of setting them manually. - Assign the new
CultureInfoobject toCurrentCultureandCurrentUICultureproperties.
System.Globalization.CultureInfo newCulture = (System.Globalization.CultureInfo)System.Globalization.CultureInfo.CurrentCulture.Clone();
// Use the dot symbol as a thousand separator
newCulture.NumberFormat.NumberGroupSeparator = ".";
// Use the comma symbol as a decimal separator
newCulture.NumberFormat.NumberDecimalSeparator = ",";
// Show currency in euros
newCulture.NumberFormat.CurrencySymbol = "€";
// Copy date-time format from the en-us culture
newCulture.DateTimeFormat = new CultureInfo("En-US").DateTimeFormat;
System.Threading.Thread.CurrentThread.CurrentCulture = newCulture;
System.Threading.Thread.CurrentThread.CurrentUICulture = newCulture;