LocalizationConverter implements IMultiValueConverter, which means it is designated for data binding with a MultiBinding declaration.

LocalizationConverter makes it easy to merge one or more dynamic values based on a templated string. For instance, consider a TextBlock that displays the status of a file upload control such as "Uploading 3 of 10 files". With MultiBinding and LocalizationConverter, you can easily display a localized resource using data binding, and have the resource updated automatically whenever one of the specified data binding property changes.

LocalizationConverter dispatches the given values in the following manner:

• The first value of the {Binding} represents the template text to be displayed in the declared property. The text may contain dynamic placeholders with each placeholder numbered starting from zero, such as "Uploading {0} of {1} files".
• The remaining values of the {Binding} will be used to replace the dynamic placeholders that is defined in the first value. In the above example, the second value replaces the {0} placeholder, while the third value replaces the {1} placeholder.

The following example shows how to define the LocalizationConverter and MultiBinding in XAML to achieve the example referred in the above description.

<Intersoft:UXPage.Resources>
    <core:LocalizationConverter x:Key="LocalizationConverter"/>
</Intersoft:UXPage.Resources>

<TextBlock HorizontalAlignment="Center">
    <core:BindingFramework.MultiBinding>
        <core:MultiBinding TargetProperty="Text" Converter="{StaticResource LocalizationConverter}">
            <core:BindingCollection>
                <Binding Path="ProgressStatus" Source="{StaticResource UploadResource}"/>
                <core:RelativeBinding Path="TotalUploadingFiles" RelativeSourceMode="TemplatedParent" ParentType="UXFileUpload"/>
                <core:RelativeBinding Path="TotalFilesToUpload" RelativeSourceMode="TemplatedParent" ParentType="UXFileUpload"/>
            </core:BindingCollection>
        </core:MultiBinding>
    </core:BindingFramework.MultiBinding>
</TextBlock>

For more information about ClientUI Localization Manager, see Localization Overview.

System.Object
   Intersoft.Client.Framework.LocalizationConverter

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

LocalizationConverter Members
Intersoft.Client.Framework Namespace