6.2 KiB

Исходник Постоянная ссылка Ответственный История

title	page_title	description	slug	tags	position
Globalization and Localization	NET MAUI - Localization and Globalization - Telerik UI	Discover how to leverage the Telerik UI for .NET MAUI controls for MAUI localization and globalization features.	globalization-localization	maui localization, maui, localization, globalization, datepicker, maskedentry, timepicker, timespanpicker, culture, device culture, numeric input	6

Globalization and Localization

Localization and Globalization is the process of designing and developing your application in such a way that it adapts to different languages and culture configurations.

This topic provides an overview on how you could utilize the Telerik .NET MAUI localization and globalization feature of the Telerik .NET MAUI controls.

Globalization

Globalization refers to developing an application in such a way that it works with respect to the target device culture. This includes numbers formatting which can vary between cultures, especially for some specific symbols, such as decimal separators, currency and other, as well as date and time formatting. Following is a list of Telerik .NET MAUI controls that support globalization:

Calendar
DatePicker
DateTimePicker
MaskedEntry
NumericInput
Scheduler
TimePicker
TimeSpanPicker

Localization

Localization refers to the translation of application resources into localized versions for the specific languages that the application supports. Check below a list of Telerik .NET MAUI controls that support localization:

[Conversational UI(Chat)]({%slug chat-localization%})
[DataForm]({% slug dataform-localization%})
[DataGrid]({% slug datagrid-localization%})
[ImageEditor]({% slug imageeditor-localization%})
[MaskedEntry]({% slug maskedentry-localization%})
[DatePicker]({% slug datepicker-localization%})
[DateTimePicker]({% slug datetimepicker-localization%})
[ListPicker]({% slug listpicker-localization%})
[Scheduler]({% slug scheduler-localization%})
[TemplatedPicker]({% slug templatedpicker-localization%})
[TimePicker]({% slug timepicker-localization%})
[TimeSpanPicker]({% slug timespanpicker-localization%})
[PDF Viewer]({% slug pdfviewer-localization%})

The localization mechanism in Telerik .NET MAUI controls is implemented through TelerikLocalizationManager class and more specifically the TelerikLocalizationManager.Manager static property. To enable localization to any of the listed above components you should choose between the approaches below:

Localization using Custom Localization Manager
Localization using ResourceManager

In both cases you would need to provide a translation of all the resource keys used inside the supported controls.

Localization using Custom Localization Manager

To apply localization to your controls just instantiate your custom TelerikLocalizationManager and set it to the static property TelerikLocalizationManager.Manager, before the creation of the UI. Below you could find an example with MaskedEntry control.

Create a custom class that inherits from TelerikLocalizationManager and override the GetString() method:

public class CustomTelerikLocalizationManager : TelerikLocalizationManager
{
   public override string GetString(string key)
   {
       if (key == "EmailMaskedEntry_InvalidMessage")
       {
           return "Email ist ungültig";
       }

       if (key == "RegexMaskedEntry_InvalidMessage")
       {
           return "Eingabe stimmt nicht mit der Regex überein";
       }

       if (key == "TextMaskedEntry_IncompleteMessage")
       {
           return "Maske ist unvollständig";
       }

       return base.GetString(key);
   }
}

Add the namespace:

using Telerik.Maui;

Set it as the TelerikLocalizationManager.Manager:

TelerikLocalizationManager.Manager = new CustomTelerikLocalizationManager();

Add the namespace:

using Telerik.Maui;

important You should set the custom manager before the InitializeComponent() method is invoked otherwise the default values will be applied to the RadMaskedEntry.

Localization using ResourceManager

The second option for applying localization is through setting a custom ResourceManager.

In the same way as the built-in mechanism for localizing .NET applications uses RESX files and the classes in the System.Resources and System.Globalization namespaces, Telerik .NET MAUI controls rely on similar setup to achieve the functionality.

You should add different resource .RESX files according to the different languages/cultures which you would like to use. Imagine that you want to translate your control, MaskedEntry for example, into English and German. You will have to add two new resource files to your .NET MAUI project with Embedded resource Build action:

MaskResource.resx - this resource file will store the English(default) resources for the MaskedEntry control.
MaskResource.de.resx - this resource file will store the German resources for the MaskedEntry control. It will be automatically used when the language of the target device is set to German.

Next image shows an example of a custom resource file used for German:

In order to apply the localization from the MaskResource resource files, you would need to set the ResourceManager property of the TelerikLocalizationManager.Manager to the MaskResource.ResourceManager:

TelerikLocalizationManager.Manager.ResourceManager = MaskResource.ResourceManager;

InitializeComponent();