稳扎稳打Silverlight(15) - 2.0数据之一次绑定, 单向绑定, 双向绑定, INotifyPropertyChanged, 数据转换, 数据验证

[索引页]
[源码下载]

稳扎稳打Silverlight(15) - 2.0数据之一次绑定, 单向绑定, 双向绑定, 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 - 出现验证错误或解决上次验证错误则触发此事件


在线DEMO
http://www.cnblogs.com/webabcd/archive/2008/10/09/1307486.html


示例
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;
            }
        }
    }
}

OK
[源码下载]