The Wayback Machine - https://web.archive.org/web/20140807001108/http://www.codeguru.com:80/columns/vb/localization-in-vb.net.htm

Localization in VB.NET

Introduction

Localization allows you to customize your application according to a certain culture. Today I will show you how to Localize your application to three different cultures.

It is always good to learn by example, so let's do a project.

Our Project

Our little project is a Windows Forms project with two controls: a Combobox and a label. It looks like Figure 1.

Our design
Figure 1 - Our design

Now, adding localization capabilities isn't that difficult at all. It is actually pretty easy as VB takes care of everything for you. Now, isn't that cool?

In design view, click on the form and open the Properties window.

Select the Form's Language property and you will notice that it is set to Default. The trick here is that when we set it to something else, it will automatically localize our application!

Set the Form's Localizable Property to True. This enables Localization.

Change the form's Language property to English and then change the Label's Text, as shown in the next image:

English Label
Figure 2 - English Label

Change the Form's Language property to French, and change the Label's text to:

French Label
Figure 3 - French Label

You might have noticed that with the very first text you had to supply, that it is a strange language as well. That is Afrikaans, my mother-tongue. We now have three languages at play here: Afrikaans, English, and French.

When a user's Locale has been set to any of those, the associated text will be displayed.

We can take it a step further! Add the next code:

   Imports System.Globalization
		Imports System.ComponentModel  
		
		Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load

        'Add items to combobox
        ComboBox1.Items.Add("English")
        ComboBox1.Items.Add("Afrikaans")
        ComboBox1.Items.Add("French")

    End Sub

    Private Sub comboBox1_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)

        If ComboBox1.SelectedIndex = 0 Then

            ChangeLanguage("en")

        ElseIf ComboBox1.SelectedIndex = 1 Then

            ChangeLanguage("af-AF")

        Else

            ChangeLanguage("fr-FR")

        End If

    End Sub

This loads items into the combobox, and determines which item has been selected.

Add the final piece of the puzzle:

    Private Sub ChangeLanguage(ByVal Language As String)

        For Each c As Control In Me.Controls

            Dim crmLang As ComponentResourceManager = New ComponentResourceManager(GetType(Form1))

            crmLang.ApplyResources(c, c.Name, New CultureInfo(Language)) 'Set desired language

        Next c

    End Sub

This sets the locale based on the resources. Now where do the resources come from?

Build your project. Once built, expand all the items inside the Solution Explorer. It should resemble Figure 4. You will see that the resource files for Afrikaans as well as French have been created.

Solution Explorer with new resources
Figure 4 - Solution Explorer with new resources

Conclusion

I hope you have enjoyed today's article. This is me signing off!



Related Articles

Downloads

Comments

  • There are no comments yet. Be the first to comment!

Top White Papers and Webcasts

  • The hard facts on SaaS adoption in over 80,000 enterprises: Public vs. private companies Mid-market vs. large enterprise GoogleApps, Office365, Salesforce & more Why security is a growing concern Fill out the form to download the full cloud adoption report.

  • With 81% of employees using their phones at work, companies have stopped asking: "Is corporate data leaking from personal devices?" and started asking: "How do we effectively prevent corporate data from leaking from personal devices?" The answer has not been simple. ZixOne raises the bar on BYOD security by not allowing email data to reside on the device. In addition, Zix allows employees to maintain complete control of their personal device, therefore satisfying privacy demands of valued employees and the …

Most Popular Programming Stories

More for Developers

Latest Developer Headlines

RSS Feeds