Localization in .NET MAUI Cartesian Chart

10 Jul 20262 minutes to read

Localization is the process of translating the application resources into different languages for the specific cultures. The SfCartesianChart can be localized by adding resource file.

NOTE

Prerequisite: Ensure that the required NuGet package is installed, the necessary namespaces are imported, and the SfCartesianChart control is properly configured in your application. For detailed setup and configuration instructions, refer to the Getting Started guide.

Setting CurrentUICulture to the application

Application culture can be changed by setting CurrentUICulture. in App.xaml.cs file.

using Syncfusion.Maui.Charts;
using System.Resources;

public partial class App : Application
{
	public App()
	{
		InitializeComponent();
		CultureInfo.CurrentUICulture = new CultureInfo("fr-FR");
		// ResXPath => Full path of the resx file; For example : 
		//SfCartesianChartResources.ResourceManager = new ResourceManager
		// ("CartesianChartSample.Resources.SfCartesianChart", Application.Current.GetType().Assembly);
        
		var ResXPath= "CartesianChartSample.Resources.SfCartesianChart";
		SfCartesianChartResources.ResourceManager = new ResourceManager(ResXPath, Application.Current.GetType().Assembly);
		MainPage = new MainPage();
	}
}

NOTE

The required resx files with Build Action as EmbeddedResource (File name should contain culture code) into the Resources folder.

Localize application level

To localize the Chart based on CurrentUICulture using resource files, follow the below steps.

  1. Right-click on the Resources folder, select Add and then New Item.

  2. In Add New Item, select the Resource File option and name the filename as SfCartesianChart.<culture name>.resx. For example, give the name as SfCartesianChart.fr-FR.resx for French culture.

  3. The culture name indicates the name of the language and country.

Shows the name of resource file to be added for .NET MAUI Cartesian Chart

  1. Now, select Add option to add the resource file in Resources folder.

Shows the added resource file for French language in .NET MAUI Cartesian Chart

  1. Add the Name/Value pair in Resource Designer of SfCartesianChart.fr-FR.resx file and change its corresponding value to corresponding culture.

Shows the added resource file name-value pair in the Resource Designer in .NET MAUI Cartesian Chart

Here, you can see how localization was performed for the tooltip.
Example for localization