Localization

The localization support for RadWizard lets you translate some of the control’s predefined strings.

Localization property

By changing the values of each of its named properties, you change the appearance of the respective strings:

<telerik:radwizard id="RadWizard8" runat="server" width="500px" Localization-Next="Next" Localization-Finish="Finish" >
    <WizardSteps>
        <telerik:RadWizardStep Title="First Step">
            <telerik:RadTextBox RenderMode="Lightweight" ID="RadTextBox17" Label="First Name:" runat="server"></telerik:RadTextBox>
            <br />
            <telerik:RadTextBox RenderMode="Lightweight" ID="RadTextBox18" Label="Last Name:" runat="server"></telerik:RadTextBox>
        </telerik:RadWizardStep>
        <telerik:RadWizardStep Title="Second Step">
        </telerik:RadWizardStep>
        <telerik:RadWizardStep Title="Finish Step" StepType="Finish">
        </telerik:RadWizardStep>
    </WizardSteps>
</telerik:radwizard>

This technique is useful when customizing some of the strings of a particular instance . The messages are not shared between RadWizard instances. A complete translation using this approach is inappropriate.

Global Resource files

The primary means for localization in ASP.NET is to use resource files. Resource files are simple XML files that can be easily edited and transferred to other applications. You can use resource files to change the default (English) localization for RadWizard that is stored in the Telerik.Web.UI assembly.

Follow these steps to create a global resource file to localize the RadWizard:

1. Create the App_GlobalResources folder in the root of your Web Application.

2. Copy the default resource RadWizard.resx file into it. This file can be found in the App_GlobalResources folder of the directory where you installed RadControls for ASP.NET AJAX.

3. Make a copy of the file and rename the copy so that its name contains the Culture Identifier. The resource files used by RadWizard follow a strict naming convention: RadWizard..resx

   The Culture Identifier consists of a language code followed by a dash and the country code. Example: “en-US”, “fr-CA” and so on.

   For example, add the RadWizard.fr-FR.resx file to the App_GlobalResources folder (both localization files should be present there):

4. Edit the strings using the Visual Studio editor or your favorite text editor. Customize strings just as you would set the Localization property.

   Make sure that the ReservedResource entry is preserved. It is used for identification purposes and is never displayed.

   You can now switch the resource file RadWizard uses with the new one: