Edit this page

Multi-Language Support for RadChart

caution

RadChart has been replaced by RadHtmlChart, Telerik's client-side charting component. If you are considering RadChart for new development, examine the RadHtmlChart documentation and online demos first to see if it will fit your development needs. If you are already using RadChart in your projects, you can migrate to RadHtmlChart by following these articles: Migrating Series, Migrating Axes, Migrating Date Axes, Migrating Databinding, Features parity. Support for RadChart is discontinued as of Q3 2014, but the control will remain in the assembly so it can still be used. We encourage you to use RadHtmlChart for new development.

RadChart bridges off the rich localization feature set already built into ASP.NET 2.0. See the following resources for background information and tools for ASP.NET 2.0 localization:

See the following localization tutorials:

The resources used for localization can be local or global:

Local resources are used for the controls on a specific page. This method assumes the existence of a resource file located in the ASP.NET Folder App_LocalResources with the same name as the page you're translating. So, if you're localizing default.aspx, ASP.NET expects to see default.aspx.resx (the default language), and translated versions e.g. default.aspx.fr-FR.resx for a French translation.

Resources can also be global, i.e. shared anywhere in the application. This method uses a resource file located in the ASP.NET folder App_GlobalResource.

There are two syntaxes used in specifying items on the page that need translation, Explicit and Implicit:

  • Explicit uses expression binding syntax like that used for binding data in-line to the ASP.NET HTML page. This type of expression can be used to identify both local and global resources. In the example below the chart title Text property is being explicitly set to a resource item named "Title" in the resource file \App_GlobalResource\MyGlobals.resx.
<charttitle>
   <TextBlock Text="<$ Resources>"></TextBlock>
</charttitle>
  • Implicit assumes the existence of a resource file located in the ASP.NET Folder App_LocalResources with the same name as the page you're translating. Notice in the example below the meta:resourcekey attribute. The resource key in the HTML ties back to the name of the resource item in the resource file. Using the resource key and the property value in the resource file you can define any number of properties.In the example below the chart title text name in the resource file is formatted as , i.e. "RadChart1Resource1.ChartTitle.TextBlock.Text".
<telerik:RadChart ID="RadChart1" runat="server" enableembeddedskins="False"
meta:resourcekey="RadChart1Resource1">
<PlotArea>
   <YAxis MaxValue="50">
   </YAxis>
   <YAxis2 MaxValue="3" MinValue="1" Step="1">
   </YAxis2>
   <XAxis MaxValue="3" MinValue="1" Step="1">
   </XAxis>
</PlotArea>
<ChartTitle>
   <TextBlock Text="Sales">
   </TextBlock>
</ChartTitle>
...    
note

Localization can also be performed using the Microsoft Localization API to retrieve resources programmatically at runtime.