WPF如何将窗口对象绑定到自定义用户控件及代码错误排查

现有代码错误排查 #

你的代码存在4个直接导致功能无法运行的问题：

• 依赖属性注册类型错误：DetailsComponent中注册ModelProperty时，错误将属性类型声明为bool，和实际存储的ModelClass类型不匹配，传值时会直接触发类型转换失败。
• 主窗口绑定源不符合规则：WPF绑定仅能识别公共属性，你定义的Model是私有字段，绑定系统无法读取到值；另外你虽然继承了INotifyPropertyChanged接口，但没有实现对应的PropertyChanged事件，属性值变更时界面无法收到更新通知。
• 用户控件绑定路径错误：你将用户控件的DataContext设为自身后，直接写{Binding Name}会读取控件自身的Name属性，而非Model属性下的Name字段；同时XAML里残留了注释多余的</TextBlock>-->标签，会导致XAML解析报错。
• 赋值顺序问题：你在主窗口构造函数里先给Model赋值、后设置DataContext，就算把Model改成公共属性，首次绑定也会因为赋值时DataContext未就绪拿不到初始值。

修正后可运行代码 #

1. 自定义控件后台代码（DetailsComponent.xaml.cs） #

public partial class DetailsComponent : UserControl
{
    // 修正依赖属性注册的类型为ModelClass
    public static readonly DependencyProperty ModelProperty = DependencyProperty.Register(
        nameof(Model), 
        typeof(ModelClass), 
        typeof(DetailsComponent), 
        new PropertyMetadata(null));

    public ModelClass Model
    {
        get => (ModelClass)GetValue(ModelProperty);
        set => SetValue(ModelProperty, value);
    }

    public DetailsComponent()
    {
        InitializeComponent();
        DataContext = this;
    }
}

2. 自定义控件XAML代码（DetailsComponent.xaml） #

修正绑定路径，删除无效残留标签：

<UserControl x:Class="WpfApp3.DetailsComponent"
         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:WpfApp3"
         mc:Ignorable="d" 
         d:DesignHeight="450" d:DesignWidth="800">
<Grid>
    <StackPanel Margin="10">
        <TextBlock Text="{Binding Model.Name}" />
        <TextBlock Text="{Binding Model.Description}" Margin="0 5 0 0"/>
        <TextBlock Text="{Binding Model.City}" Margin="0 5 0 0"/>
    </StackPanel>
</Grid>
</UserControl>

3. 主窗口后台代码（MainWindow.xaml.cs） #

将Model改为公共属性，实现属性变更通知，调整赋值顺序：

public partial class MainWindow : Window, INotifyPropertyChanged
{
    private ModelClass _model;

    public ModelClass Model
    {
        get => _model;
        set
        {
            _model = value;
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Model)));
        }
    }

    public MainWindow()
    {
        InitializeComponent();
        // 先设置DataContext再给绑定属性赋值
        DataContext = this;
        Model = new ModelClass("hi", "hi", "hi");
    }

    public event PropertyChangedEventHandler PropertyChanged;
}

其他说明 #

• 主窗口XAML中引用的LoadingSpinnerControl、materialDesign命名空间如果没有实际使用可以直接删除，不影响功能运行。
• 如果后续需要在运行时修改ModelClass的属性值（比如修改Name后界面同步更新），给ModelClass也实现INotifyPropertyChanged接口即可。
• 如果需要监听控件内Model属性的变更，可以在依赖属性注册时添加PropertyChangedCallback参数实现自定义逻辑。

内容的提问来源于stack exchange，提问作者pado