WPF中创建带TextBox的自定义UserControl实现数据绑定失败问题

你遇到的问题核心是内部TextBox的绑定源找错了——当你在自定义UserControl的XAML里写{Binding CustomText}时，默认会使用UserControl的DataContext（也就是你外部绑定的包含FirstName的那个对象），而不是UserControl自身的CustomText依赖属性，所以绑定自然无法生效。

下面是两种简单有效的修复方案：

方案1：使用RelativeSource绑定到UserControl自身 #

修改自定义控件内部的TextBox绑定，明确指定绑定源为当前UserControl：

<Grid>
    <TextBox x:Name="tb" Text="{Binding CustomText, RelativeSource={RelativeSource AncestorType=local:CustomTextBox}}"/>
</Grid>

或者更通用的写法（不用指定具体类型，用UserControl即可）：

<TextBox x:Name="tb" Text="{Binding CustomText, RelativeSource={RelativeSource AncestorType=UserControl}}"/>

方案2：使用ElementName绑定 #

先给你的UserControl根节点起个名字，然后通过ElementName指向它：

<UserControl x:Class="YourNamespace.CustomTextBox"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:YourNamespace"
             x:Name="root">
    <Grid>
        <TextBox x:Name="tb" Text="{Binding CustomText, ElementName=root}"/>
    </Grid>
</UserControl>

额外优化建议 #

你的CustomText依赖属性注册是正确的，如果后续需要在属性值变化时执行额外逻辑，可以给依赖属性添加PropertyMetadata，同时指定默认值：

public static readonly DependencyProperty CustomTextProperty = DependencyProperty.Register(
    "CustomText", 
    typeof(string), 
    typeof(CustomTextBox),
    new PropertyMetadata(string.Empty, OnCustomTextChanged) // 添加默认值和变化回调
);

private static void OnCustomTextChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    // 这里可以处理属性变化后的自定义逻辑，比如更新内部控件状态
}

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