New to Telerik UI for ASP.NET AJAX? Download free 30-day trial

Localization through global resources

RadPivotGrid supports built-in localization through Global resources. Similar to RadEditor, RadScheduler and RadGrid you can use the .resx files to localize the control with minimum efforts.

Using the resource files

The resource files should be placed within the App_GlobalResources folder in your application. You can either create your own language pack (see below) or use an existing one (if available for your language). UI controls installation wizard automatically copies the built-in resources to the App_GlobalResources in your local installation. pivotgrid-logalization-global-resources 1

To change the current language/resource you should set the Culture property accordingly.

RadPivotGrid's default Culture is taken from the page's CurrentUICulture .

            <telerik:RadPivotGrid RenderMode="Lightweight" ID="RadPivotGrid1"    runat="server"    Culture="en-US" ... </telerik:RadPivotGrid>

Here is how to localize your RadPivotGrid in simple steps:

  1. Create a new resource file or copy an existing one from the App_GlobalResources in your installation folder

  2. Add the resource file (resx) file to the App_GlobalResources folder in your application. Note that you should have two files as a bare minimum - RadPivotGrid.Main.resx and the localization file itself - for example

  3. Set the Culture property to the corresponding language (for example: it-IT, en-GB, ja-JP and so on) pivotgrid-logalization-global-resources 2

Creating/Modifying resource files

The resource files are represented in a human-readible format (XML) and can be easily modified either in the built-in Visual Studio resource editor or directly in the file, by hand. pivotgrid-logalization-global-resources 3 pivotgrid-logalization-global-resources 4

How to create a new localization resource

The process of creating a new global resource follows the same pattern as in RadEditor, RadScheduler and RadGrid controls.

  1. Make a copy of the RadPivotGrid.Main.resx file and save it as RadPivotGrid.Main.YOURLANGUAGE.resx (for example: RadPivotGrid.Main.ja-JP.resx)

  2. Replace the default strings with the translated ones

  3. Set the Culture property to the relevant language

Please ** -do not- ** modify/remove the ReservedResource key.

We encourage that you submit your localized resource files. Your efforts will be rewarded accordingly.

You can find a complete list of the culture codes here.

In this article