Click here to Skip to main content
Click here to Skip to main content

.NET Resource (.resx file) Translator

, 27 Aug 2012
Rate this:
Please Sign up or sign in to vote.
A .NET resource (.resx file) translator. English to any other language.

Main Window

Introduction

Apart from the default language of the application (generally English), your software should support different languages since people prefer using software with a native language interface. For the worldwide distribution of an application, you need to translate the user interface to as many languages as possible. When you do that, you can say the application is Globalized.

The first step to globalize an application is setting the Localizable property of the Windows Form to true. When you create a Forms based Windows application, there is a resource (.resx) file associated with each form. This resource file is specific to a language which contains all locale specific details of that form.

In this article, we will discuss how to generate a different language resource file from the default English resource file.

Background

I have posted an article on Globalization/Internationalization too. Before reading this article, please read: Globalization, Internationalization (I18N), and Localization using C# and .NET 2.0.

Using the Code

The text translation is based on the translation provided by the Google Translator website (http://translate.google.com).

Although the Google Translator .NET API classes are available, The usage of these APIs are not free now. So I have updated the source code to read the translated data directly from website. 

Here, we have the Translator class which basically uses the Google Translator Website to translate the text. It sends the text with appropriate parameters to the website and extracts translated text from the response. 

/// <summary>
/// Translates the given text in the given language.
/// </summary>
/// <param name="targetLanguage">Target language.</param>
/// <param name="value">Text to be translated.</param>
/// <returns>Translated value of the given text.</returns>
public static string Translate(Language targetLanguage, string text)
{
    string translatedValue = string.Empty;
    try
    {
        string languagePair = string.Format("en|{0}", targetLanguage.Value);
        // Get the translated value.
        translatedValue = TranslateText(text, languagePair);
        Trace.WriteLine(string.Format("Given Text is {0} and Target Language is {1}. Result - {2}.",
            text, targetLanguage.Name, translatedValue));
    }
    catch (Exception ex)
    {
        string errorString = "Exception while translating, please check the connectivity." + ex.Message;
        Trace.WriteLine(errorString);
        throw new WebException(errorString);
    }
    return translatedValue;
}

Once the given text is translated in the target language, the only work left is creating a .resx file and adding the text into that file. The code given below performs this task:

/// <summary>
/// Translates the given resx in the specified language. new language resx
/// file will be created in the same folder and with the same name suffixed with
/// the locale name.
/// </summary>
/// <param name="targetLanguage">Language in which text to be translated.</param>
/// <param name="resxFilePath">Source resx file path</param>
public static void Write(Language targetLanguage, 
       string resxFilePath, bool onlyTextStrings)
{
    if (string.IsNullOrEmpty(resxFilePath))
    {
        throw new ArgumentNullException(resxFilePath, 
          "Resx file path cannot be null or empty");
    }
    if (targetLanguage == null)
    {
        throw new ArgumentNullException(targetLanguage, 
                  "Target Language cannot be null");
    }
    using (ResXResourceReader resourceReader = new ResXResourceReader(resxFilePath))
    {
        //string locale = targetLanguage.ToString().Substring(0, 2).ToLower();
        string locale = targetLanguage.Value.ToLower();
        #region Create locale specific directory.
        //string outputFilePath = Path.Combine(Path.GetDirectoryName(ResxFilePath),
            locale);
        //if (!Directory.Exists(outputFilePath))
        //{
        // Directory.CreateDirectory(outputFilePath);
        //} 
        #endregion
        // Create the required file name with locale.
        string outputFilePath = Path.GetDirectoryName(resxFilePath);
        string outputFileName = Path.GetFileNameWithoutExtension(resxFilePath);
        outputFileName += "." + locale + ".resx";
        outputFilePath = Path.Combine(outputFilePath, outputFileName);
        // Create a resx writer.
        using (ResXResourceWriter resourceWriter = new ResXResourceWriter(outputFilePath))
        {
            foreach (DictionaryEntry entry in resourceReader)
            {
                string key = entry.Key as string;
                // Check if the Key is UI Text element.
                if (!String.IsNullOrEmpty(key))
                {
                    if (onlyTextStrings)
                    {
                        if (!key.EndsWith(".Text"))
                        {
                            continue;
                        }
                    }
                    string value = entry.Value as string;
                    // check for null or empty
                    if (!String.IsNullOrEmpty(value))
                    {
                        // Get the translated value.
                        string translatedValue = Translator.Translate(targetLanguage,
                            value);
                        // add the key value pair.
                        resourceWriter.AddResource(key, translatedValue);
                    }
                }
            }
            // Generate resx file.
            resourceWriter.Generate();
        }
    }
}

Since the text translation happens at the Google website, it takes time to fetch the text and get the translated text. I have used the BackgroundWorker class to do this job. The BackgroundWorker initiates the process by Binding the channel and then sending and receiving the text with the specified languages.

The BackgroundWorker class allows you to run an operation on a separate, dedicated thread. Time-consuming operations like downloads and database transactions can cause your user interface (UI) to seem as though it has stopped responding while they are running. When you want a responsive UI and you are faced with long delays associated with such operations, the BackgroundWorker class provides a convenient solution.

private void myStartButton_Click(object sender, EventArgs e)
{
    *                 
    *            
    myBackgroundWorker.RunWorkerAsync(languages);        
    *
    *
}
void myBackgroundWorker_DoWork(object sender, DoWorkEventArgs e)
{
    BackgroundWorker worker = sender as BackgroundWorker;
    Language[] languages = e.Argument as Language[];
    PerformTranslation(languages, worker, e, myOnlyTextCheckBox.Checked);
}

Once you hit the Start Translation button on the UI, the BackgroundWorker starts the text translation. In case you want to abort the background process, call the CancelAsync() method and then check for the CancellationPending flag on the BackgoundWorker instance, and set DoWorkEventArgs - e.Cancel to true.

/// <summary>
/// Perform translation for each selected language for all selected resx files.
/// </summary>
/// <param name="languages">selected languages.</param>
/// <param name="worker">BackgroundWorker instance.</param>
/// <param name="e">DoWorkEventArgs.</param>
/// <param name="onlyTextStrings">true; to convert only '.Text' keys valus.</param>
private void PerformTranslation(Language[] languages, 
        BackgroundWorker worker, DoWorkEventArgs e, bool onlyTextStrings)
{
    int totalProgress = 0;
    foreach (string file in mySelectedFiles)
    {
        foreach (Language targetLanguage in languages)
        {
            if (worker.CancellationPending)
            {
                e.Cancel = true;
            }
            else
            {
                ResxWriter.Write(targetLanguage, file, onlyTextStrings);
                totalProgress++;
                worker.ReportProgress(totalProgress);
            }
        }
    }
}

There could be two types of .resx files. When you set the Localizable property to true, the entire information of the form (specific to a locale) is moved to the .resx file, including location, size, etc. This is an auto generated resource file which contains the entries other than the UI text strings. Another option could be a user defined resource file, which contains only strings.

In the Resx Translator application UI, you can select the 'Convert only .Text key' checkbox in order to convert only strings of the auto generated .resx files. Translating entries other than strings can cause some serious errors. In the case of the user defined resource file, you can leave this option.

There are two components in this application - the Translator and the Config UIs. In the Translator UI, you can browse and select the .resx files. In the Config UI, you can select the languages in which you want to translate your English .resx files.

Once the translation starts, the progress bar and the status bar will indicate the whole process. Hope this tool will help you to generate resource files in different languages. Wink | ;)

Points of Interest 

It reads the translated data directly from website. You should have an active internet connection to get the translated data.  

Please go through the code for better understanding of translation/extraction process. 

Sometimes during development phase you may need to verify whether the application is truly localized (all UI Text is getting translated to target language/culture) or not. You can do this by just tweaking the Translator class code. For a particular language instead of actually translating the text just return the reversed text (or prefix/suffix one character). Now after loading the application in that particular language you can easily validate all the translated texts in the UI.  

History 

  • 23/08/2012 - Modified code to read translated data from Google Translator website.  
  • 08/02/2010 - Added details of APIs.
  • 04/02/2010 - Uploaded source code.
  • 04/02/2010 - Initial post.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Kumar, Ravikant INDIA Bangalore
Software Developer (Senior) Philips
India India
Have been working with computers since the early 00's. Since then I've been building, fixing, configuring, installing, coding and designing with them. At present I mainly code windows applications in C#, WCF, WPF and SQL. I'm very interested in Design Patterns and try and use these generic principles in all new projects to create truly n-tier architectures. Also I like to code for making the User Interface very attractive...
Follow on   Twitter

Comments and Discussions

 
QuestionDoes not HTML encode and HTML decode the data PinmemberGregory Morse20-May-14 21:18 
GeneralMy vote of 4 Pinmembersamthec2-Apr-13 4:00 
SuggestionGIT hub more collaborative working PinmemberBryan Avery1-Nov-12 22:56 
QuestionError PinmemberRene Laviolette4-Sep-12 2:53 
AnswerRe: Error PinmemberKumar, Ravikant INDIA Bangalore4-Sep-12 18:35 
Questionthis is very useful utility which saves lot of hours Pinmemberharikakakkireni30-Aug-12 21:04 
AnswerRe: this is very useful utility which saves lot of hours PinmemberKumar, Ravikant INDIA Bangalore30-Aug-12 23:17 
GeneralMy vote of 4 PinmemberChristian Amado27-Aug-12 9:22 
GeneralRe: My vote of 4 PinmemberKumar, Ravikant INDIA Bangalore30-Aug-12 23:22 
Questioncomment Pinmemberemrankhan24-Aug-12 8:37 
AnswerRe: comment PinmemberKumar, Ravikant INDIA Bangalore30-Aug-12 23:21 
GeneralA good idea, but... PinmemberMatt T Heffron23-Aug-12 6:42 
GeneralRe: A good idea, but... PinmemberKumar, Ravikant INDIA Bangalore23-Aug-12 17:35 
Questiontry this instead.. Pinmembersamthec16-Jun-12 3:06 
AnswerRe: try this instead.. PinmemberKumar, Ravikant INDIA Bangalore22-Aug-12 23:50 
GeneralMy vote of 1 [modified] Pinmembersamthec16-Jun-12 1:15 
GeneralRe: My vote of 1 PinmemberKumar, Ravikant INDIA Bangalore22-Aug-12 23:48 
GeneralRe: My vote of 1 PinmemberFernandoUY23-Aug-12 11:07 
GeneralMy vote of 5 Pinmemberpathakpankaj14-May-12 20:19 
GeneralRe: My vote of 5 PinmemberKumar, Ravikant INDIA Bangalore29-Jul-12 19:23 
GeneralMy vote of 3 PinmemberBishisht Bhatta29-Mar-12 21:32 
GeneralRe: My vote of 3 PinmemberKumar, Ravikant INDIA Bangalore29-Jul-12 19:21 
GeneralMy vote of 5 Pinmembermanoj kumar choubey2-Feb-12 0:04 
Questiongoogle translate is not free anymore, Pinmemberwei10000014-Jan-12 5:20 
AnswerRe: google translate is not free anymore, PinmemberHexadigm Systems27-Jan-12 5:55 
GeneralRe: google translate is not free anymore, PinmemberKumar, Ravikant INDIA Bangalore22-Aug-12 23:50 
GeneralMy vote of 4 PinmemberRajeshkumar Chavada27-Nov-11 19:35 
GeneralRe: My vote of 4 PinmemberKumar, Ravikant INDIA Bangalore29-Jul-12 19:19 
QuestionWhen One File Translate then error generate PinmemberRajeshkumar Chavada27-Nov-11 19:34 
AnswerRe: When One File Translate then error generate PinmemberKumar, Ravikant INDIA Bangalore5-Dec-11 21:30 
Question"индусcкий код" Pinmembersoad171515-Nov-11 1:58 
QuestionGoogle translate API v2 Pinmemberpnduffy11-Oct-11 11:06 
AnswerRe: Google translate API v2 PinmemberKumar, Ravikant INDIA Bangalore16-Nov-11 21:43 
AnswerRe: Google translate API v2 PinmemberKumar, Ravikant INDIA Bangalore22-Aug-12 23:53 
GeneralRe: Google translate API v2 Pinmemberpnduffy23-Aug-12 4:31 
GeneralGetting error in VS2008 PinmemberMizan Rahman23-May-11 1:48 
GeneralRe: Getting error in VS2008 Pinmemberinvaders@earthling.net10-Jan-12 13:21 
GeneralRe: Getting error in VS2008 PinmemberKumar, Ravikant INDIA Bangalore12-Jan-12 21:58 
GeneralTranslate Language using resource file to my web site. PinmemberMember 47502133-May-11 1:16 
GeneralRe: Translate Language using resource file to my web site. PinmemberKumar, Ravikant India Bangalore9-May-11 0:03 
Generalthanks for sharing - have 5 PinmemberPranay Rana30-Jan-11 18:54 
GeneralMy vote of 4 Pinmemberdfigure29-Dec-10 5:23 
GeneralDealing with legacy code pages Pinmemberdfigure29-Dec-10 5:20 
GeneralRe: My vote of 2 PinmemberKumar, Ravikant India Bangalore26-Dec-10 22:48 
QuestionRe: My vote of 2 PinmemberChesnokov Yuriy26-Dec-10 23:51 
AnswerRe: My vote of 2 PinmemberKumar, Ravikant India Bangalore27-Dec-10 18:29 
QuestionPoor exception handling and code layout, how do you handle ResXResourceReader exceptions? PinmemberChesnokov Yuriy26-Dec-10 21:51 
GeneralA really helpful tool PinmemberJax000000999999920-Aug-10 0:05 
GeneralGoogle API Access Notice Pinmemberpeterfoo10-Aug-10 3:54 
GeneralRe: Google API Access Notice PinmemberKumar, Ravikant India Bangalore10-Aug-10 6:33 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web01 | 2.8.140721.1 | Last Updated 27 Aug 2012
Article Copyright 2010 by Kumar, Ravikant INDIA Bangalore
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid