Binding.Converter property

Applies to Windows and Windows Phone

Gets or sets the converter object that is called by the binding engine to modify the data as it is passed between the source and target, or vice versa.

Syntax


public:
property IValueConverter^ Converter { 
   IValueConverter^ get();
   void set (IValueConverter^ value);
}


<Binding Converter="converterReference"/>

XAML Values

converterReference

A reference to an existing object that implements IValueConverter and functions as a converter. Typically the object is created in a ResourceDictionary and given a key, then referenced by using the StaticResource markup extension. For example: <Binding Converter="{StaticResource myConverter}" .../>

Property value

Type: IValueConverter

The IValueConverter object that modifies the data.

Remarks

Create a converter by implementing the IValueConverter interface and implementing the Convert method. That method should return an object that is of the same type as the dependency property that the binding targets, or at least a type that can be implicitly coerced or converted to the target type.

Examples

To use your converter in a binding, first create an instance of your converter class. The following example shows this as a resource in a XAML file.


<UserControl.Resources>
  <local:DateToStringConverter x:Key="Converter1"/>
</UserControl.Resources>


Then set the Converter property for the binding to that instance.


<TextBlock Grid.Column="0" Margin="5,0"
  Text="{Binding Month, Converter={StaticResource Converter1}}"/>


Implement the converter code as follows.

No code example is currently available or this language may not be supported.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml.Data
Windows::UI::Xaml::Data [C++]

Metadata

Windows.winmd

See also

Binding
XAML data binding sample
Data binding overview

 

 

Show:
© 2014 Microsoft