WPF自定义UserControl嵌入ItemsControl模板后的绑定异常解决

问题根源分析 #

1. 类型转换异常：删除按钮的CommandParameter绑定到了ComboBox选中的枚举值（MyEnum），而非DataEntry对象，导致类型转换失败。
2. 选中项不同步：UserControl未正确暴露依赖属性，内部ComboBox的绑定未与外部ViewModel的Values集合建立双向联动，且DataContext的误用导致绑定上下文混乱。

具体解决步骤 #

1. 给自定义UserControl添加正确的依赖属性

在UserControl的后台代码中，添加两个关键依赖属性：一个用于绑定DataEntry对象本身，另一个用于绑定ComboBox的选中值（双向绑定）：

public partial class EntryControl : UserControl
{
    // 绑定整个DataEntry对象的依赖属性
    public static readonly DependencyProperty EntryProperty =
        DependencyProperty.Register(nameof(Entry), typeof(DataEntry), typeof(EntryControl));

    // 绑定ComboBox选中值的双向依赖属性
    public static readonly DependencyProperty SelectedValueProperty =
        DependencyProperty.Register(nameof(SelectedValue), typeof(MyEnum), typeof(EntryControl), 
            new FrameworkPropertyMetadata(default(MyEnum), FrameworkPropertyMetadataOptions.BindsTwoWayByDefault));

    public DataEntry Entry
    {
        get => (DataEntry)GetValue(EntryProperty);
        set => SetValue(EntryProperty, value);
    }

    public MyEnum SelectedValue
    {
        get => (MyEnum)GetValue(SelectedValueProperty);
        set => SetValue(SelectedValueProperty, value);
    }

    public EntryControl()
    {
        InitializeComponent();
    }
}

2. 调整UserControl内部的绑定逻辑

修改UserControl的XAML，确保内部控件绑定到UserControl的依赖属性，而非直接使用DataContext（避免外部DataContext覆盖问题）：

<UserControl x:Class="WpfApp1.EntryControl"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             x:Name="Self">
    <StackPanel Orientation="Horizontal">
        <!-- ComboBox绑定到UserControl的SelectedValue属性 -->
        <ComboBox SelectedItem="{Binding ElementName=Self, Path=SelectedValue}"
                  ItemsSource="{Binding Source={StaticResource MyEnumValues}}"/>
        <!-- 删除按钮的CommandParameter绑定到UserControl的Entry属性 -->
        <Button Content="删除" 
                Command="{Binding ElementName=Self, Path=DataContext.DeleteCommand}"
                CommandParameter="{Binding ElementName=Self, Path=Entry}"/>
    </StackPanel>
</UserControl>

注意：MyEnumValues是你定义的枚举资源，用于填充ComboBox选项。

3. 外部ItemsControl中正确使用UserControl

在主窗口的ItemsControl里，将ItemTemplate替换为自定义UserControl，并绑定对应的依赖属性：

<ItemsControl ItemsSource="{Binding Values}">
    <ItemsControl.ItemTemplate>
        <DataTemplate>
            <!-- 绑定当前DataEntry对象到Entry属性，SelectedValue绑定到DataEntry的Data属性 -->
            <local:EntryControl Entry="{Binding}" 
                                SelectedValue="{Binding Data, Mode=TwoWay}"/>
        </DataTemplate>
    </ItemsControl.ItemTemplate>
</ItemsControl>

关键注意点 #

• 避免直接在UserControl内部使用{Binding}（默认绑定DataContext），改用ElementName或RelativeSource绑定到UserControl自身的依赖属性，防止外部DataContext干扰。
• 确保SelectedValue依赖属性设置了BindsTwoWayByDefault，这样ComboBox的选中值会自动同步到ViewModel的Values集合中的DataEntry.Data属性。
• 删除按钮的CommandParameter必须绑定到完整的DataEntry对象，而非其内部的Data属性，这样删除命令才能正确识别要移除的项。

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