WPF自定义UserControl绑定报错：普通属性无法用Binding求解决方案

错误信息 #

System.Windows.Markup.XamlParseException: '"Binding" cannot be set for the "PropertyMargin" property of type "TxtInput". "Binding" can only be set for a "DependencyProperty" of a "DependencyObject"

问题原因 #

WPF的数据绑定机制仅支持绑定到DependencyObject类型的DependencyProperty，你当前用普通CLR属性实现PropertyMargin，不符合绑定要求；同时将TxtInput的DataContext设为自身，会阻断父ViewModel的上下文继承，导致绑定逻辑混乱。

解决步骤 #

1. 将CLR属性改为依赖属性 #

在TxtInput的后台代码中，把PropertyMargin（以及需要动态绑定的PropertyName）重构为依赖属性：

// 定义PropertyMargin依赖属性
public static readonly DependencyProperty PropertyMarginProperty =
    DependencyProperty.Register(
        nameof(PropertyMargin), 
        typeof(Thickness), 
        typeof(TxtInput), 
        new PropertyMetadata(new Thickness(0)));

public Thickness PropertyMargin
{
    get => (Thickness)GetValue(PropertyMarginProperty);
    set => SetValue(PropertyMarginProperty, value);
}

// 如果PropertyName需要支持动态绑定，同样改为依赖属性
public static readonly DependencyProperty PropertyNameProperty =
    DependencyProperty.Register(
        nameof(PropertyName), 
        typeof(string), 
        typeof(TxtInput), 
        new PropertyMetadata(string.Empty));

public string PropertyName
{
    get => (string)GetValue(PropertyNameProperty);
    set => SetValue(PropertyNameProperty, value);
}

2. 移除控件自身的DataContext设置 #

删除TxtInput后台代码中DataContext = this;的语句，让控件继承父容器的DataContext。同时在TxtInput的XAML中，用RelativeSource绑定内部元素到自身的依赖属性：

<UserControl x:Class="YourNamespace.TxtInput"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <Grid Margin="{Binding PropertyMargin, RelativeSource={RelativeSource AncestorType=UserControl}}">
        <!-- 示例：绑定内部文本块到PropertyName -->
        <TextBlock Text="{Binding PropertyName, RelativeSource={RelativeSource AncestorType=UserControl}}"/>
        <!-- 其他控件内容 -->
    </Grid>
</UserControl>

3. 父控件中正常绑定使用 #

在父UserControl的XAML中，直接将TxtInput的依赖属性绑定到父ViewModel的属性即可：

<local:TxtInput PropertyName="用户名" 
                PropertyMargin="{Binding NameMargin}"/>

这里的NameMargin是父ViewModel中定义的Thickness类型属性。

效果说明 #

修改后，TxtInput可以在任意视图中复用，无需绑定到特定ViewModel；依赖属性支持动态绑定，父ViewModel的属性值变化会自动同步到控件样式，同时控件继承父上下文，不会干扰父视图的绑定逻辑。

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