Localization Asset

This tutorial shows how to load language strings from an external file.

Add new text file "HelloWorld.ini" into the C# project.

Paste the following text to the HelloWorld.ini, and then save the document.

Type:TutorialProject.Program:Key:Hello = Hello World!

[Culture:en]
Type:TutorialProject.Program:Key:Hello = Hello World!

[Culture:fi]
Type:TutorialProject.Program:Key:Hello = Hei Maailma!

[Culture:sv]
Type:TutorialProject.Program:Key:Hello = Hej världen!

[Culture:de]
Type:TutorialProject.Program:Key:Hello = Hallo Welt!

Go to properties of HelloWorld.ini and change Copy to Output Directory to Copy always. Now the file will be copied to the .exe folder.

Next, open the Program.cs and modify the code to the following.

using Lexical.Localization;
using Lexical.Localization.Asset;
using System;
using System.Globalization;

namespace TutorialProject
{
    public class Program
    {
        public static void Main(string[] args)
        {
            // Create a loader
            IAsset asset = IniLinesReader.Default.FileAsset("HelloWorld.ini");

            // Add asset to global singleton instance
            LineRoot.Builder.AddAsset(asset);
            LineRoot.Builder.Build();

            // Take reference of the root
            ILineRoot root = LineRoot.Global;

            // Create key
            ILine key = root.Type<Program>().Key("Hello").Format("Hello World!");

            // Print with current culture
            Console.WriteLine(key);

            // Print with other cultures
            CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("de");
            Console.WriteLine(key);

            CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("fi");
            Console.WriteLine(key);

            CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("sv");
            Console.WriteLine(key);

            Console.ReadKey();
        }
    }
}

Now run the program.