Le data binding est une des fonctionnalités les plus puissantes de Silverlight et WPF. Il n'est plus nécessaire de passer du temps à faire du code pour la synchronisation des données. Cela contribue à la séparation de la partie visuelle de la partie métier.
Fonctionnement
En beta 1, le data binding est implémenté sur tout les objets qui héritent de FrameworkElement. Les propriétés de ce contrôle peuvent être liées à un objet source spécifiée lors du binding ou être liées au contexte de binding en cours. Le binding en cours est stockée par la propriété DataContext.
1 <UserControl x:Class="Ucaya.SilverlightTest.Page"
2 xmlns="http://schemas.microsoft.com/client/2007"
3 xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
4 xmlns:sys="clr-namespace:System;assembly=mscorlib"
5 Width="400" Height="300">
6 <UserControl.Resources>
7 <sys:String x:Name="src">Binding source</sys:String>
8 </UserControl.Resources>
9 <StackPanel x:Name="LayoutRoot" Background="White">
10 <TextBlock x:Name="tb1" Text="{Binding Source={StaticResource src}}"/>
11 <TextBlock x:Name="tb2" Text="{Binding Length, Source={StaticResource src}}"/>
12 </StackPanel>
13 </UserControl>
Ici, le TextBlock tb1 a sa propriété Text bindée à l'objet src qui se trouve dans les ressources. N'ayant pas spécifié de chemin dans la binding, c'est l'objet lui même qui est lié.
Le TextBlock tb2 est lié à la propriété Length de la source.
1 <UserControl x:Class="Ucaya.SilverlightTest.Page"
2 xmlns="http://schemas.microsoft.com/client/2007"
3 xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
4 xmlns:sys="clr-namespace:System;assembly=mscorlib"
5 Width="400" Height="300">
6 <UserControl.Resources>
7 <sys:String x:Name="src">Binding source</sys:String>
8 </UserControl.Resources>
9 <Grid x:Name="LayoutRoot" Background="White">
10 <ListBox x:Name="lb" ItemsSource="{Binding Source={StaticResource src}}">
11 <ListBox.ItemTemplate>
12 <DataTemplate>
13 <TextBlock x:Name="tb" Text="{Binding }"/>
14 </DataTemplate>
15 </ListBox.ItemTemplate>
16 </ListBox>
17 </Grid>
18 </UserControl>
La ListBox est bindée de la même manière que dans l'exemple 1. La string étant énumérable, la ListBox instancie un ItemTemplate par valeur de l'énumération.
Le TextBlock à sa propriété Text bindée au contexte de binding en cours fourni par la ListBox. Comme dans l'exemple 1, n'ayant pas fourni de chemin de binding, c'est directement la source du binding qui est liée.
Modes de binding
La synchronisation des valeurs peut se faire de différente manière.
OneTime
La donnée est recopiée de la source vers le contrôle une seule fois lorsque le binding est créé.
OneWay
La donnée est mise à jour dans le sens source vers contrôle à chaque fois que la valeur de la source change. Pour que le binding soit notifié du changement, l'objet source du binding doit implémenter l'interface INotifyPropertyChanged pour les propriétés et INotifyCollectionChanged pour les collections.
TwoWay
La donnée est mise à jour dans le sens source vers contrôle à chaque fois que la valeur de la source change (sous réserve de l'implémentation de INotifyPropertyChanged ou INotifyCollectionChanged) et dans le sens contrôle vers source quand la valeur du contrôle change.
Conversion des données
Il arrive que les données sources ne puissent être converties directement entre les propriétés d'un contrôle et les valeurs de la source. C'est là qu'interviennent les classes de conversion. Elles permettent par exemple de convertir un string en Uri, un string en ImageSource ou encore de formatter un double en string avec 2 nombres après la virgule. Ces convertisseurs sont des classes qui implémentent l'interface IValueConverter.
Implémentation d'un convertisseur effectuant un string.Format. Affiche une valeur en pourcentage.
Xaml:
<UserControl x:Class="Ucaya.SilverlightTest.Page"
xmlns="http://schemas.microsoft.com/client/2007"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:sys="clr-namespace:System;assembly=mscorlib"
xmlns:sle="clr-namespace:SLExtensions.Data;assembly=SLExtensions"
Width="400" Height="300">
<UserControl.Resources>
<sys:Double x:Key="src">0.333333</sys:Double>
<sle:StringFormatConverter x:Key="formater"/>
<sys:String x:Key="formatString">{0:p}</sys:String>
</UserControl.Resources>
<StackPanel x:Name="LayoutRoot" Background="White">
<TextBlock x:Name="tb1"
Text="{Binding Converter={StaticResource formater}, ConverterParameter={StaticResource formatString}, Source={StaticResource src}}"/>
</StackPanel>
</UserControl>
Convertisseur:
// <copyright file="StringFormatConverter.cs" company="SLExtensions.Controls">
// Distributed under Microsoft Public License (Ms-PL)
// </copyright>
namespace SLExtensions.Data
{
using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Documents;
using System.Windows.Ink;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Animation;
using System.Windows.Shapes;
using System.Windows.Data;
/// <summary>
/// Convert data to string objects as it passes through the binding engine.
/// </summary>
public class StringFormatConverter : IValueConverter
{
/// <summary>
/// Default string format syntax
/// </summary>
private const string DefaultStringFormat = "{0}";
#region IValueConverter Members
/// <summary>
/// Convert source data to string before passing it to the target for display in the UI.
/// </summary>
/// <param name="value">The source data being passed to the target.</param>
/// <param name="targetType">The <see cref="T:System.Type"/> of data expected by the target dependency property.</param>
/// <param name="parameter">An optional parameter to be used in the converter logic.</param>
/// <param name="culture">The culture of the conversion.</param>
/// <returns>
/// The value to be passed to the target dependency property.
/// </returns>
public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
{
if (targetType != typeof(string))
{
throw new ArgumentException(Resource.StringFormatConverterExceptionInvalidTargetType);
}
if (value == null)
{
return string.Empty;
}
string format = (parameter as string) ?? DefaultStringFormat;
return string.Format(format, value);
}
/// <summary>
/// This convertion is not supported
/// </summary>
/// <param name="value">The target data being passed to the source.</param>
/// <param name="targetType">The <see cref="T:System.Type"/> of data expected by the source object.</param>
/// <param name="parameter">An optional parameter to be used in the converter logic.</param>
/// <param name="culture">The culture of the conversion.</param>
/// <returns>
/// The value to be passed to the source object.
/// </returns>
object IValueConverter.ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
{
throw new NotSupportedException();
}
#endregion
}
}