数据之一次绑定, 单向绑定, 双向绑定, INotifyPropertyChanged, 数据转换, 数据验证(转)

作者：webabcd


介绍
Silverlight 2.0 数据绑定：
    Binding - 将绑定目标对象的属性与数据源联接起来
        Source - 绑定的数据源
        Mode - 绑定的数据流的方向 [System.Windows.Data.BindingMode枚举]
            BindingMode.OneTime - 一次绑定。创建绑定时一次性地更新绑定目标对象的属性
            BindingMode.OneWay - 单向绑定（默认值）。数据源的改变会自动通知到绑定目标对象的属性
            BindingMode.TwoWay - 双向绑定。数据源或绑定目标对象的属性的值发生改变时会互相通知。显然，做数据验证的话一定要是双向绑定
        Path - 需要绑定的属性名称
        NotifyOnValidationError - 产生验证错误时是否触发 BindingValidationError 事件。默认值为 false
        ValidatesOnExceptions - 产生验证错误时绑定引擎是否要报告错误。默认值为 false
    INotifyPropertyChanged - 向客户端发出某一属性值已更改的通知
    IValueConverter - 值转换接口，将一个类型的值转换为另一个类型的值。它提供了一种将自定义逻辑应用于绑定的方式
        Convert - 正向转换器。将值从数据源传给绑定目标时，数据绑定引擎会调用此方法
        ConvertBack - 反向转换器。将值从绑定目标传给数据源时，数据绑定引擎会调用此方法
    BindingValidationError - 出现验证错误或解决上次验证错误则触发此事件

示例
1、NotifyProperty.xaml（演示INotifyPropertyChanged）

<UserControl x:Class="Silverlight20.Data.NotifyProperty"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <StackPanel HorizontalAlignment="Left">

        <!--
        Binding - 将绑定目标对象的属性与数据源联接起来（本例为将 Ellipse的Fill属性 与 MyColor的Brush属性 相联）
        Mode - Binding 的扩展属性之一，默认为 OneWay（单向绑定），即数据源的改变会自动通知到绑定目标对象的属性
        -->
        <Ellipse x:Name="ellipse" Width="100" Height="50" Fill="{Binding Brush, Mode=OneWay}" MouseLeftButtonDown="ellipse_MouseLeftButtonDown" />

    </StackPanel>
</UserControl>

NotifyProperty.xaml.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Animation;
using System.Windows.Shapes;

using System.ComponentModel;

namespace Silverlight20.Data
{
    public partial class NotifyProperty : UserControl
    {
        MyColor _myColor;

        public NotifyProperty()
        {
            InitializeComponent();

            this.Loaded += new RoutedEventHandler(NotifyProperty_Loaded);
        }

        void NotifyProperty_Loaded(object sender, RoutedEventArgs e)
        {
            _myColor = new MyColor { Brush = new SolidColorBrush(Colors.Red) };

            // DataContext - FrameworkElement 做数据绑定时的数据上下文
            // 将 MyColor 对象绑定到 Ellipse
            ellipse.DataContext = _myColor;
        }

        private void ellipse_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
        {
            // 鼠标按下后修改 MyColor 对象的属性
            // 如果MyColor实现了INotifyPropertyChanged接口，并且绑定目标的BindingMode为OneWay或者TwoWay的话则会自动通知到绑定目标
            if (_myColor.Brush.Color == Colors.Red)
                _myColor.Brush = new SolidColorBrush(Colors.Green);
            else
                _myColor.Brush = new SolidColorBrush(Colors.Red);
        }
    }

    /**//*
     * INotifyPropertyChanged - 向客户端发出某一属性值已更改的通知
     * 使用 OneWay 或者 TwoWay 的话必须要实现 INotifyPropertyChanged 接口
    */
    public class MyColor : INotifyPropertyChanged
    {
        private SolidColorBrush _brush;
        public SolidColorBrush Brush
        {
            get { return _brush; }
            set
            {
                _brush = value;
                if (PropertyChanged != null)
                {
                    // 触发 PropertyChanged 事件，事件参数为属性名称
                    PropertyChanged(this, new PropertyChangedEventArgs("Brush"));
                }
            }
        }

        // 声明一个 PropertyChanged 事件
        public event PropertyChangedEventHandler PropertyChanged;
    }
}

2、Conversion.xaml（演示数据转换）

<!--引用转换器所在的命名空间-->
<UserControl x:Class="Silverlight20.Data.Conversion"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:custom="clr-namespace:Silverlight20.Data">
    
    <UserControl.Resources>
    
        <!--在资源中声明转换器-->
        <custom:ColorEnumToBrush x:Key="converter" />
        
    </UserControl.Resources>
    
    <StackPanel HorizontalAlignment="Left">

        <!--
        Converter - 用于指定转换器
        ConverterParameter - 转换器所使用的参数
        ConverterCulture - 转换器所使用的区域信息
        -->
        <Ellipse x:Name="ellipse" Width="100" Height="50" MouseLeftButtonDown="ellipse_MouseLeftButtonDown" 
            Fill="{Binding ColorEnum, Converter={StaticResource converter}, ConverterParameter=10}" 
        />

    </StackPanel>
</UserControl>

Conversion.xaml.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Animation;
using System.Windows.Shapes;

using System.ComponentModel;
using System.Windows.Data;

namespace Silverlight20.Data
{
    public partial class Conversion : UserControl
    {
        MyColorEnum _myColorEnum;

        public Conversion()
        {
            InitializeComponent();

            this.Loaded += new RoutedEventHandler(Conversion_Loaded);
        }

        void Conversion_Loaded(object sender, RoutedEventArgs e)
        {
            _myColorEnum = new MyColorEnum() { ColorEnum = ColorEnum.Red };

            // DataContext - FrameworkElement 做数据绑定时的数据上下文
            // 将 MyColorEnum 对象绑定到 Ellipse
            ellipse.DataContext = _myColorEnum;
        }

        private void ellipse_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
        {
            // 鼠标按下后修改 MyColorEnum 对象的属性
            if (_myColorEnum.ColorEnum == ColorEnum.Red)
                _myColorEnum.ColorEnum = ColorEnum.Green;
            else
                _myColorEnum.ColorEnum = ColorEnum.Red;
        }
    }

    /**//*
     * IValueConverter - 值转换接口，将一个类型的值转换为另一个类型的值。它提供了一种将自定义逻辑应用于绑定的方式
     *     Convert - 正向转换器。将值从数据源传给绑定目标时，数据绑定引擎会调用此方法
     *     ConvertBack - 反向转换器。将值从绑定目标传给数据源时，数据绑定引擎会调用此方法
    */
    public class ColorEnumToBrush : IValueConverter
    {
        /**//// <summary>
        /// 正向转换器。将值从数据源传给绑定目标时，数据绑定引擎会调用此方法
        /// </summary>
        /// <param name="value">转换之前的值</param>
        /// <param name="targetType">转换之后的类型</param>
        /// <param name="parameter">转换器所使用的参数</param>
        /// <param name="culture">转换器所使用的区域信息</param>
        /// <returns>转换后的值</returns>
        public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
        {
            // 将 ColorEnum 类型的值转换为 SolidColorBrush 类型的值

            // parameter == 10

            ColorEnum color = (ColorEnum)value;

            SolidColorBrush brush = new SolidColorBrush(Colors.Red);

            if (color == ColorEnum.Green)
                brush = new SolidColorBrush(Colors.Green);

            return brush;
        }

        /**//// <summary>
        /// 反向转换器。将值从绑定目标传给数据源时，数据绑定引擎会调用此方法
        /// </summary>
        /// <param name="value">转换之前的值</param>
        /// <param name="targetType">转换之后的类型</param>
        /// <param name="parameter">转换器所使用的参数</param>
        /// <param name="culture">转换器所使用的区域信息</param>
        /// <returns>转换后的值</returns>
        public object ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
        {
            return null;
        }
    }

    /**//*
     * INotifyPropertyChanged - 向客户端发出某一属性值已更改的通知
     * 使用 OneWay 或者 TwoWay 的话必须要实现 INotifyPropertyChanged 接口
    */
    public class MyColorEnum : INotifyPropertyChanged
    {
        private ColorEnum _colorEnum;
        public ColorEnum ColorEnum
        {
            get { return _colorEnum; }
            set
            {
                _colorEnum = value;
                if (PropertyChanged != null)
                {
                    // 触发 PropertyChanged 事件，事件参数为属性名称
                    PropertyChanged(this, new PropertyChangedEventArgs("ColorEnum"));
                }
            }
        }

        // 声明一个 PropertyChanged 事件
        public event PropertyChangedEventHandler PropertyChanged;
    }

    /**//// <summary>
    /// 自定义的 ColorEnum 枚举
    /// </summary>
    public enum ColorEnum
    {
        Red,
        Green
    }
}

3、Validation.xaml（演示数据验证）

<!--引用验证类所在的命名空间-->
<UserControl x:Class="Silverlight20.Data.Validation"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:custom="clr-namespace:Silverlight20.Data">
    
    <!--
    BindingValidationError - 出现验证错误或解决上次验证错误则触发此事件
    -->
    <StackPanel HorizontalAlignment="Left" BindingValidationError="StackPanel_BindingValidationError" >
        
        <StackPanel.Resources>
        
            <!--在资源中声明验证类-->
            <custom:MyValidation x:Name="myValidation"/>
            
        </StackPanel.Resources>
        
        <TextBox x:Name="textBox" Width="200" Margin="5">
            <TextBox.Text>
            
                <!--
                Binding - 将绑定目标对象的属性与数据源联接起来
                    Source - 绑定的数据源
                    Mode - 绑定的数据流的方向 [System.Windows.Data.BindingMode枚举]
                        BindingMode.OneTime - 一次绑定。创建绑定时一次性地更新绑定目标对象的属性
                        BindingMode.OneWay - 单向绑定（默认值）。数据源的改变会自动通知到绑定目标对象的属性
                        BindingMode.TwoWay - 双向绑定。数据源或绑定目标对象的属性的值发生改变时会互相通知。显然，做数据验证的话一定要是双向绑定
                    Path - 需要绑定的属性名称
                    NotifyOnValidationError - 产生验证错误时是否触发 BindingValidationError 事件。默认值为 false
                    ValidatesOnExceptions - 产生验证错误时绑定引擎是否要报告错误。默认值为 false
                -->
                <Binding 
                    Source="{StaticResource myValidation}"  
                    Mode="TwoWay" 
                    Path="Count"
                    NotifyOnValidationError="True" 
                    ValidatesOnExceptions="True"
                />
                    
            </TextBox.Text>
        </TextBox>
        
        <TextBox x:Name="textBox2" Width="200"  Margin="5" />
           
    </StackPanel>
    
</UserControl>

Validation.xaml.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Animation;
using System.Windows.Shapes;

using System.Text.RegularExpressions;

namespace Silverlight20.Data
{
    public partial class Validation : UserControl
    {
        public Validation()
        {
            InitializeComponent();
        }

        private void StackPanel_BindingValidationError(object sender, ValidationErrorEventArgs e)
        {
            // ValidationErrorEventArgs - 用于提供 BindingValidationError 事件的一些信息
            //     ValidationErrorEventArgs.Action - 验证状态
            //     ValidationErrorEventArgs.Error - 触发 BindingValidationError 事件的错误信息
            //     ValidationErrorEventArgs.Handled - 标记该路由事件是否已被处理
            // ValidationErrorEventAction.Added - 因为出现验证错误而触发此事件
            // ValidationErrorEventAction.Removed - 因为解决上次验证错误而触发此事件

            if (e.Action == ValidationErrorEventAction.Added)
            {
                textBox.Background = new SolidColorBrush(Colors.Red);
                textBox.Text = e.Error.Exception.Message;
            }
            else if (e.Action == ValidationErrorEventAction.Removed)
            {
                textBox.Background = new SolidColorBrush(Colors.White);
            }
        }
    }

    /**//// <summary>
    /// 验证类。验证是否为正整数
    /// </summary>
    public class MyValidation
    {
        private string _count;
        public string Count
        {
            get { return _count; }
            set
            {
                if (!Regex.IsMatch(value, @"^\d+$"))
                {
                    // 绑定引擎可以报告由属性的 setter 抛出的异常，也可以报告由转换器（IValueConverter）抛出的异常
                    throw new Exception("必须是正整数");
                }

                _count = value;
            }
        }
    }
}