WPF程序设计指南: Binding(数据绑定)[上]
注:一下内容及代码基本来自Charles Petzold著,蔡学庸译,电子工业出版社出版的《Windows Presentation Foundation 程序设计指南》一书
1. 绑定概述
- 数据绑定(data binding)是将控件和element链接到数据的技术。它常常可以取代事件处理函数,大大简化代码。
- 数据绑定具有源(source)和目标(target),一般来说,源是某种数据,目标则是一个控件。(有时候角色会对调)
- “绑定”一定是在target上做设定
- 绑定的目标必须继承自DependcyObject,绑定所设定的property必须有dependency property的支持
2. 简单实例
代码
<StackPanel xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
<!-- Binding Source. -->
<ScrollBar Name="scroll"
Orientation="Horizontal" Margin="24"
Maximum="100" LargeChange="10" SmallChange="1" />
<!-- Binding Target. -->
<Label HorizontalAlignment="Center"
Content="{Binding ElementName=scroll, Path=Value}" />
</StackPanel>
代码说明:
- label的content将会实时显示Scrollbar的Value值的变化
- 要注意语法,如果不习惯用大括号,还可以这么写
<Label.Content>
<Binding ElementName="scroll" Path="Value" /></Label.Content> -
c#代码设定:
Binding bind = new Binding();
bind.Source = scroll;
bind.Path = new PropertyPath(ScrollBar.ValueProperty);
lbl.SetBinding(Label.Content, bind);
3. 绑定的4种模式
- Mode=“OneWay”
源到目标的绑定 - Mode=“TwoWay”
双向的绑定 - Mode=“OneTime”
一次绑定,它从目标源取的数据,进行初始化,但不会持续跟踪变化 - Mode=“OneWayToSource”
目标到源的绑定,即“源根据目标来更新”。当目标的property没有denpendcy property支持,而源的property有denpendcy property支持时,可以将绑定放在源上,然后设置为该绑定模式。
注:默认的绑定模式是不确定的,所以最好显示地指定绑定模式
4. 通过DataContext属性绑定
DataContext可以沿着element tree中被继承,所以如果你为一个element设定DataContext,则该element所有的孩子都会受到影响,例如:
代码
<StackPanel xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
DataContext="{Binding ElementName=scroll}">
<!-- Binding Source. -->
<ScrollBar Name="scroll"
Orientation="Horizontal" Margin="24"
Minimum="1" Maximum="100" LargeChange="10" SmallChange="1" />
<!-- Binding Targets. -->
<Label HorizontalAlignment="Center"
Content="{Binding Path=Value, Mode=OneWay}" />
<Button HorizontalAlignment="Center" Margin="24"
FontSize="{Binding Path=Value, Mode=OneWay}">
Bound Button
</Button>
</StackPanel>
如果在一个面板内,许多控件都绑定到一个特定对象的不同property上,只要将DataContext设定到该类型的不同对象上,所以的控件都会反应此新对象的内容。
5. Converter
当数据传递时,可能需要转换数据,Binding类包括了一个Coverter的property,该属性的对象类型必须实现接口:IvalueConverter
格式如下:
代码
public class MyConverter : IValueConverter
{
/// <summary>
/// 源到目标的转换
/// </summary>
/// <param name="value">绑定源生成的值</param>
/// <param name="typeTarget">绑定目标属性的类型,也就是该方法的返回类型</param>
/// <param name="param">要使用的转换器参数(附加参数,可以是任何数据类型或者对象引用)</param>
/// <param name="culture">要用在转换器中的区域性(一般可以忽略)</param>
public object Convert(object value, Type typeTarget,
object param, CultureInfo culture)
{
//...
}
/// <summary>
/// 目标到源的转换
/// </summary>
/// <param name="value">绑定目标生成的值</param>
/// <param name="typeTarget">要转换到的类型,也就是该方法的返回类型</param>
/// <param name="param">要使用的转换器参数</param>
/// <param name="culture">要用在转换器中的区域性</param>
public object ConvertBack(object value, Type typeTarget,
object param, CultureInfo culture)
{
//...
}
}
在c#中使用以上定义的Converter:
Binding bind = new Binding();
bind.Converter = new MyConverter();
在XAML中使用以上定义的Converter,需要先将其加到Resource中,在Resources section中:
<src:MyConverter x:Key="conv" />
然后使用:
"{Binding ... Convert={StaticResource conv}, ... }"
6. 一个使用Converter的数据绑定完整实例
在c#代码中定义Converter,将数据在double和decimal中转换
代码
using System;
using System.Globalization;
using System.Windows;
using System.Windows.Data;
namespace Petzold.DecimalScrollBar
{
[ValueConversion(typeof(double), typeof(decimal))]
public class DoubleToDecimalConverter : IValueConverter
{
public object Convert(object value, Type typeTarget,
object param, CultureInfo culture)
{
decimal num = new Decimal((double)value);
if (param != null)
num = Decimal.Round(num, Int32.Parse(param as string));
return num;
}
public object ConvertBack(object value, Type typeTarget,
object param, CultureInfo culture)
{
return Decimal.ToDouble((decimal)value);
}
}
}
代码说明:
-
MSDN建议在定义Converter之前使用ValueConversion(ValueConversionAttribute类) attribute,指定转换器的实现中涉及的数据类型。
- 注意上面用到了附加参数param,用来控制小数点位数。
在XAML文件中使用数据绑定:
代码
<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:src="clr-namespace:Petzold.DecimalScrollBar"
Title="Decimal ScrollBar">
<Window.Resources>
<src:DoubleToDecimalConverter x:Key="conv" />
</Window.Resources>
<StackPanel>
<!-- Binding Source. -->
<ScrollBar Name="scroll"
Orientation="Horizontal" Margin="24"
Maximum="100" LargeChange="10" SmallChange="1" />
<!-- Binding Target. -->
<Label HorizontalAlignment="Center"
Content="{Binding ElementName=scroll, Path=Value,
Converter={StaticResource conv}, ConverterParameter=2}" />
</StackPanel>
</Window>
代码说明:
- 注意引用命名空间
- 通过设置ConverterParameter property,指定保留两位小数。
- 当移动滚动条时,label会显示两位小数的Value值
7. 多重绑定(multi-binding)
- 多重绑定将来自多个源的多个对象,合并为一个单一的目标。
- 多重绑定的转换器必须实现IMultiValueConverter接口
实现IMultiValueConverter接口的例子
代码
public class RgbToColorConverter : IMultiValueConverter
{
public object Convert(object[] value, Type typeTarget,
object param, CultureInfo culture)
{
Color clr = Color.FromRgb((byte)(double)value[0],
(byte)(double)value[1],
(byte)(double)value[2]);
if (typeTarget == typeof(Color))
return clr;
if (typeTarget == typeof(Brush))
return new SolidColorBrush(clr);
return null;
}
public object[] ConvertBack(object value, Type[] typeTarget,
object param, CultureInfo culture)
{
Color clr;
object[] primaries = new object[3];
if (value is Color)
clr = (Color)value;
else if (value is SolidColorBrush)
clr = (value as SolidColorBrush).Color;
else
return null;
primaries[0] = clr.R;
primaries[1] = clr.G;
primaries[2] = clr.B;
return primaries;
}
}
代码说明:
- 该转换器将三个double值转换成color或者Brush
- 注意Convert的第一个参数是对象数组
使用该转换器:
代码
<Border.Background>
<MultiBinding Converter="{StaticResource convRgbToColor}">
<Binding ElementName="scrRed" Path="Value" Mode="OneWay "/>
<Binding ElementName="scrGreen" Path="Value" Mode="OneWay "/>
<Binding ElementName="scrBlue" Path="Value" Mode="OneWay "/>
</MultiBinding>
</Border.Background>
代码说明:
- 该Binding从三个ScrollBar(scrRed,scrGreen,scrBlue)中获取value值,然后传递到转换器的对象数组
- 转换器根据这个三个值返回一个Brush,设置为Border的Background属性值
- 对于MultiBinding的Binding element,也可以使用各自的转换器
8. UpdateSourceTrigger属性
- Binding的UpdateSourceTrigger属性用来设定更新绑定源的时间(在TwoWay或OneWayTOSource模式下使用)
- UpdateSourceTrigger的值为枚举类型
- LostFocus:当控件失去焦点时更新源(在数据源是数据库的情况下,可以避免频繁操作数据库)
- PropertyChanged: 当绑定的目标属性的值发生改变时更新源,这样可以实时反应目标属性的变化
- Explicit:仅在调用 UpdateSource 方法时更新绑定源
如果选用此选项,需要先在“定义此binding的element(注:按我的理解就是目标控件了)”上调用GetBindingExpression方法
// itemNameTextBox is an instance of a TextBox
BindingExpression be = itemNameTextBox.GetBindingExpression(TextBox.TextProperty);
然后在点击“更新”或“确定”按钮时,调用UpdateSource方法:
be.UpdateSource();