WPF 因設置不期望的DataContext，導致的綁定異常

在MainWindow中，創建一個背景屬性BrushTest，並將其綁定至界面上UserControl的BackgroundTest屬性

<Window x:Class="WpfApp8.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfApp8"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800" x:Name="TheMainWindow">
    <Grid>
        <local:UserControl1 BackgroundTest="{Binding BrushTest}"/>
    </Grid>
</Window>

    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
            BrushTest = Brushes.Red;
            this.DataContext = this;
        }
        public static readonly DependencyProperty BrushTestProperty = DependencyProperty.Register(
            "BrushTest", typeof(SolidColorBrush), typeof(MainWindow), new PropertyMetadata(default(SolidColorBrush)));
        public SolidColorBrush BrushTest
        {
            get { return (SolidColorBrush) GetValue(BrushTestProperty); }
            set { SetValue(BrushTestProperty, value); }
        }
    }

UserControl，同樣添加一個BackgroundTest屬性，並將其綁定至界面。

<UserControl x:Class="WpfApp8.UserControl1"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
             xmlns:local="clr-namespace:WpfApp8"
             mc:Ignorable="d" 
             d:DesignHeight="450" d:DesignWidth="800">
    <Grid Background="{Binding BackgroundTest}">
    </Grid>
</UserControl>

    public partial class UserControl1 : UserControl
    {
        public UserControl1()
        {
            InitializeComponent();
            this.DataContext = this;
        }
        public static readonly DependencyProperty BackgroundTestProperty = DependencyProperty.Register(
            "BackgroundTest", typeof(SolidColorBrush), typeof(UserControl1), new PropertyMetadata(default(SolidColorBrush)));
        public SolidColorBrush BackgroundTest
        {
            get { return (SolidColorBrush) GetValue(BackgroundTestProperty); }
            set { SetValue(BackgroundTestProperty, value); }
        }
    }

運行后，控制台輸出綁定異常，背景設置並沒有生效。

System.Windows.Data Error: 40 : BindingExpression path error: 'BrushTest' property not found on 'object' ''UserControl1' (Name='')'.

BindingExpression:Path=BrushTest; DataItem='UserControl1' (Name=''); target element is 'UserControl1' (Name=''); target property is 'BackgroundTest' (type 'SolidColorBrush')

為何錯了？

因為UserControl設置了倆次DataContext，UserControl1內部設置的上下文覆蓋了主窗口設置的上下文。

窗口內<local:UserControl1 BackgroundTest="{Binding BrushTest}"/>綁定的值BrushTest，在UserControl下的上下文無法找到相關值，所以報錯了

 

此類綁定異常，一不小心還是很容易出現的。

在窗口設置了DataContext時（自身或者ViewModel），子控件也設置DataContext。有趣的是，在Xaml編輯時，使用Reshaper鏈接到的是窗口所在的上下文屬性。

所以，子控件設置DataContext時，需要關注下是否有屬性被引用綁定外界數據。

建議子控件減少DataContext的使用，以上可以通過指定數據源進行綁定。比如：

<UserControl x:Class="WpfApp8.UserControl1"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
             xmlns:local="clr-namespace:WpfApp8"
             mc:Ignorable="d" 
             d:DesignHeight="450" d:DesignWidth="800" x:Name="TheUserControl">
    <Grid Background="{Binding ElementName=TheUserControl,Path=BackgroundTest}">
    </Grid>
</UserControl>