![\"\"](\"http:\/\/www.jonathanantoine.com\/wp-content\/uploads\/2011\/09\/DelayedBinding00.png\" "\\"DelayedBinding00\\"")
If you read the MSDN page on the new WPF 4.5 features, you’ll find it under the label “Automatically updating the source of a data binding<\/em>“. This is more precise and understandable to me to say that a ‘Delay’ property has been added to the Binding markup extension !<\/strong><\/p>\nThis post is a part of the serie on WPF 4.5 new features<\/a>. By reading it you’ll discover what is the goal of this property, how to use it and some scenario where it is really useful and smart to use it.<\/p>\n <\/p>\n A binding is done between two objects : the source (where the data comes from) and the target (where the data go to). For example if you bind the Text property of a TextBlock to a property “Name” of your ViewModel, the TextBlock is the target and the source is your ViewModel.<\/p>\n A Binding performs synchronisation between two properties. If and only if the binding is done in TwoWay mode then the target is able to update the source value (the TextBlock is able to update the ViewModel).<\/p>\n This synchronisation is done immediately : each change of the target value, even a tiny tiny one update the source.<\/p>\n Since WPF 4.5, the Binding has a new property named ‘Delay’ which defines a timespan after which the source is updated.<\/strong> Each update of the target value will be done only after this delay and only if none has been done since. MSDN defines it as “The amount of time to wait before updating the binding source<\/em>“.<\/p>\n We will see later when it can be useful.<\/p>\n As this is an added property on the Binding, you only have to define it on each Binding you create. Here is an example of a binding which sets a delay of 500 milliseconds: The delay is only applied on only one direction : from the target to the source.<\/span><\/p>\n My first though was that it is not a really useful feature but after a certain amount of time I found some scenario in which this is very useful. Yes, my brain has a Delay too !<\/p>\n The master\/detail scenarii are the one where it can be the most useful for me so I have create a demo project to reproduce it. Let’s say that we a have a list of person and the selected one’s details are displayed. We will then have an interface which looks like this : On each change of the Selected Person, a time-consuming process is triggered on the UI thread in the setter. I simulated this by a call of Thread.Sleep : When the delay is not set, navigation in the list is just slow and freeze the UI on each changes. Just letting the ‘arrow down’ key makes the UI freeze too much for me.<\/p>\n With the delay property set to a value of 500 milliseconds, I can easily navigate in the list with the keyboard. Finally, I added a button to trigger a change from the source object just to prove that the Delay works in only one direction.<\/p>\n The complete code source of the Demo can be found on my dropbox folder after registration<\/a>.<\/p>\n Again, it’s a discrete addition to the WPF framework but it’s a useful one !<\/p>\nWhat is it ?<\/h3>\n
How to use it ?<\/h3>\n
\nThe delay is defined in milliseconds and the default value of ‘0’ reproduce the classic behavior of a Binding.<\/p>\n
\n[xml]<TextBlock Text="{Binding Name, Delay=500}"\/>[\/xml]<\/p>\nWhen to use it ?<\/h3>\n
\n
A full example<\/h3>\n
\n![\"\"](\"http:\/\/www.jonathanantoine.com\/wp-content\/uploads\/2011\/09\/DelayedBinding01.jpg\" "\\"DelayedBinding01\\"")
<\/a><\/p>\n
\n[csharp]public Person SelectedPerson
\n{
\n get { return _selectedPerson; }
\n set
\n {
\n _selectedPerson = value;
\n \/\/Simulate time consuming operation
\n Thread.Sleep(500);
\n RaisePropertyChanged("SelectedPerson");
\n }
\n}
\n[\/csharp]<\/p>\n
\n[xml]<ListBox ItemsSource="{Binding Persons}" SelectedItem="{Binding SelectedPerson,Delay=500}" \/>[\/xml]<\/p>\n