WPF依赖属性的当前值(Current Value)，基值(Base Value)和本地值(Local Value)

依赖属性的当前值(Current Value)，基值(Base Value)和本地值(Local Value)是MSDN常出现的三个词，这些属性和依赖属性的优先级设置有关。

如下表：

这里是当前值 1.  1. 属性系统强制转换，这里是通过依赖属性的CoerceValueCallback 2.  2. 活动动画或者具有Hold行为的动画   这里是基值 3.  3. 本地值，通过依赖属性的SetValue方法，资源，绑定 4.  4. 其他方式如样式，触发器等……

这里列出一部分以依赖属性值优先级的情况，完整列表请参考MSDN：http://msdn.microsoft.com/zh-cn/library/ms743230.aspx

当前值：

是最外层的属性值，可能经过一些列的处理或影响而得到的最终值。

基值：

当依赖属性没有经过系统强制转换，没有经过动画处理影响的值，就是上表中在第三项之上，但没有被一和二项所影响的值。

本地值：

这个是比较直观设置的值，是通过依赖属性SetValue方法或者资源或绑定设置的值。

那么如何得到这些值呢？

当前值：通过依赖属性的GetValue方法

基值：通过IAnimatable接口的GetAnimationBaseValue方法

本地值：通过依赖属性的ReadLocalValue方法，如果没有本地值则返回DependencyProperty.UnsetValue字段

假设有两个按钮，名称分别是btn1和btn2，程序运行后，按钮的宽度（Width依赖属性）都会被DoubleAnimation动画从50变为100，两个按钮的唯一区别是btn1的Width是直接设置的。btn2的Width是通过样式的Setter设置的。

那么当动画结束后，两个按钮的Width依赖属性的具体值是这样的：

	btn1	btn2
当前值	100	100
基值	50	50
本地值	50	DependencyProperty.UnsetValue

由于动画设置了依赖属性，所以当前值是100.

而在动画前，Width都是50，所以基值都是50

而btn1直接设置了Width，就是调用了依赖属性的SetValue，所以本地值被设置。

而btn2通过样式的Setter设置Width，属于上表中的第四项，本地值没有被设置。

通过程序可以实际测试一下：

获取属性的代码参考：

 

object[] GetValues(object obj, DependencyProperty pro)
 
        {
 
            if (obj is DependencyObject == false || obj is IAnimatable == false)
 
                throw new ArgumentException();
 
            object[] re = new object[3];
 
 
 
            var dobj = (DependencyObject)obj;
 
            var ianm = (IAnimatable)obj;
 
 
 
            re[0] = dobj.GetValue(pro);
 
            re[1] = ianm.GetAnimationBaseValue(pro);
 
            re[2] = dobj.ReadLocalValue(pro);
 
            return re;
 
 
 
        }
 
 
 
        string GetValuesString(object obj, DependencyProperty pro,string name)
 
        {
 
            var objs = GetValues(obj, pro);
 
            return String.Format("{3}\n当前值：{0}\n基值：{1}\n本地值：{2}\n\n",
 
                objs[0], objs[1], objs[2], name);
 
        }

两个按钮XAML动画定义：

<Button Width="50" Height="30" Name="btn1" Content="1" >
 
            <Button.Triggers>
 
                <EventTrigger RoutedEvent="Button.Loaded">
 
                    <EventTrigger.Actions>
 
                        <BeginStoryboard>
 
                            <Storyboard>
 
                                <DoubleAnimation Storyboard.TargetProperty="Width" 

                                                 To="100" Duration="0:0:0.5"/>
 
                            </Storyboard>
 
                        </BeginStoryboard>
 
                    </EventTrigger.Actions>
 
                </EventTrigger>
 
            </Button.Triggers>
 
        </Button>
 
 
 
        <Button Height="30" Name="btn2" Content="2" >
 
            <Button.Style>
 
                <Style TargetType="Button">
 
                    <Setter Property="Width" Value="50"/>
 
                </Style>
 
            </Button.Style>
 
            <Button.Triggers>
 
                <EventTrigger RoutedEvent="Button.Loaded">
 
                    <EventTrigger.Actions>
 
                        <BeginStoryboard>
 
                            <Storyboard>
 
                                <DoubleAnimation Storyboard.TargetProperty="Width" 

                                                 To="100" Duration="0:0:0.5"/>
 
                            </Storyboard>
 
                        </BeginStoryboard>
 
                    </EventTrigger.Actions>
 
                </EventTrigger>
 
            </Button.Triggers>
 
        </Button>