There are several options for localizating a WPF application. We can use resx files, locbaml to create resource DLL’s for us, or why not just use the same technique used in theme’s, i.e. DynamicResource and ResourceDictionary’s.<\/p>\n
In this post I’m going to look at the DynamicResource and ResourceDictionary approach to localization. Although this technique can obviously be used with images etc., we’ll concentrate on dealing with strings, which usually are the main area of localization.<\/p>\n
Let’s start with some code<\/strong><\/p>\n Create a simple WPF application which will use the standard DynamicResource to set text on controls. We will create a “default” set of string resources to allow us to develop our initial application with and we will create two satellite assemblies which will contain the same string resources for en-GB and en-US resources.<\/p>\n Now in the WPF application, add a ResourceDictionary, mine’s named Strings.xaml and this will act as our default\/design-time dictionary, here’s mine<\/p>\n and my MainWindow.xaml looks like this<\/p>\n I didn’t say this was going to be exciting, did I?<\/p>\n Now if you run the application as it currently stands, you’ll see the string TBC – our design-time string.<\/p>\n Next, copy the Strings.xaml file from the application to both the Resources_en-GB and Resources_en-US and change the string text to represent your GB and US strings for header – I used the word Colour in GB and Color in US – just to demonstrate the common language differences.<\/p>\n Now if you build and run the application, you’ll see the default header text still, so we now need to make the application set the resources at start-up and allow us to easily switch them. So change the buttons in MainWindow.xaml to these<\/p>\n We’re going to simply use code behind for changing the resource in this demo. So in MainWindow.xaml.cs add the following code <\/p>\n and finally in the constructor let’s default to en-GB, so simply add this line after the InitializeComponent<\/p>\n Now run the application, be default you should see en-GB strings and then press the US button to see the en-US version etc.<\/p>\n Finishing touches<\/strong><\/p>\n In some situations we might want to switch the languages strings used via an option (very useful when debugging but also in you’re natural language is not the same as the default on your machine). In most cases, we’re likely to want to switch the language at start-up to match the machines’s culture\/language.<\/p>\n Using ResourceDictionary might look a little more complex than CSV files, but should be easy for your translators to use and being, ultimately, XML – we could ofcourse write a simple application to allow the translators to view strings etc. in a tabular format. <\/p>\n We can deploy as many or as few localized resources as we need on a machine.<\/p>\n\n
\r\n<ResourceDictionary xmlns="http:\/\/schemas.microsoft.com\/winfx\/2006\/xaml\/presentation"\r\n xmlns:x="http:\/\/schemas.microsoft.com\/winfx\/2006\/xaml"\r\n xmlns:system="clr-namespace:System;assembly=mscorlib">\r\n\r\n <system:String x:Key="Header">TBC<\/system:String>\r\n \r\n<\/ResourceDictionary>\r\n<\/pre>\n
\r\n<Window x:Class="WpfLocalizable.MainWindow"\r\n xmlns="http:\/\/schemas.microsoft.com\/winfx\/2006\/xaml\/presentation"\r\n xmlns:x="http:\/\/schemas.microsoft.com\/winfx\/2006\/xaml"\r\n xmlns:d="http:\/\/schemas.microsoft.com\/expression\/blend\/2008"\r\n xmlns:mc="http:\/\/schemas.openxmlformats.org\/markup-compatibility\/2006"\r\n xmlns:local="clr-namespace:WpfLocalizable"\r\n mc:Ignorable="d"\r\n Title="MainWindow" Height="350" Width="525">\r\n <StackPanel>\r\n <TextBlock Text="{DynamicResource Header}" FontSize="24"\/>\r\n <StackPanel Orientation="Horizontal" VerticalAlignment="Bottom">\r\n <Button Content="US" Width="100" Margin="10" \/>\r\n <Button Content="GB" Width="100" Margin="10" \/>\r\n <\/StackPanel>\r\n <\/StackPanel>\r\n<\/Window>\r\n<\/pre>\n\r\n<Button Content="US" Width="100" Margin="10" Click="US_OnClick"\/>\r\n<Button Content="GB" Width="100" Margin="10" Click="GB_OnClick"\/>\r\n<\/pre>\n
\r\nprivate void LoadStringResource(string locale)\r\n{\r\n var resources = new ResourceDictionary();\r\n\r\n resources.Source = new Uri("pack:\/\/application:,,,\/Resources_" + locale + ";component\/Strings.xaml", UriKind.Absolute);\r\n\r\n var current = Application.Current.Resources.MergedDictionaries.FirstOrDefault(\r\n m => m.Source.OriginalString.EndsWith("Strings.xaml"));\r\n\r\n\r\n if (current != null)\r\n {\r\n Application.Current.Resources.MergedDictionaries.Remove(current);\r\n }\r\n\r\n Application.Current.Resources.MergedDictionaries.Add(resources);\r\n}\r\n\r\nprivate void US_OnClick(object sender, RoutedEventArgs e)\r\n{\r\n LoadStringResource("en-US");\r\n}\r\n\r\nprivate void GB_OnClick(object sender, RoutedEventArgs e)\r\n{\r\n LoadStringResource("en-GB");\r\n}\r\n<\/pre>\n\r\nLoadStringResource("en-GB");\r\n<\/pre>\n