WPF自定义UserControl中如何实现Binding绑定？

问题根源 #

绑定失效的核心原因是在UserControl构造函数中设置了DataContext = this;。这会强制将UserControl的DataContext指向自身，覆盖了从父容器（MainWindow）继承来的ViewModel上下文。当你在MainWindow中给MyText绑定{Binding Name}时，绑定的数据源变成了MyTextBox控件本身，而非ViewModel，自然找不到Name属性，导致数据同步失效。

解决方案 #

1. 移除UserControl内的DataContext赋值

删掉MyTextBox构造函数里的DataContext = this;代码，让控件继承父级的DataContext。

2. 修改UserControl内部TextBox的绑定方式

由于不再依赖DataContext指向自身，需要明确指定绑定源为UserControl的MyText依赖属性，常用两种实现方式：

方式一：使用RelativeSource

在MyTextBox的XAML中，将TextBox的Text绑定修改为：

<TextBox Text="{Binding MyText, RelativeSource={RelativeSource AncestorType={x:Type local:MyTextBox}}}" />

方式二：使用ElementName

给UserControl设置x:Name，然后通过ElementName绑定：

<UserControl x:Class="WpfApp.MyTextBox"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:WpfApp"
             x:Name="Self">
    <Grid>
        <TextBox Text="{Binding MyText, ElementName=Self}" />
    </Grid>
</UserControl>

完整修正代码示例 #

MyTextBox C#代码

using System.Windows;
using System.Windows.Controls;

namespace WpfApp
{
    public partial class MyTextBox : UserControl
    {
        public static readonly DependencyProperty MyTextProperty =
            DependencyProperty.Register("MyText", typeof(string), typeof(MyTextBox), new PropertyMetadata(string.Empty));

        public string MyText
        {
            get => (string)GetValue(MyTextProperty);
            set => SetValue(MyTextProperty, value);
        }

        public MyTextBox()
        {
            InitializeComponent();
            // 移除该行：DataContext = this;
        }
    }
}

MyTextBox XAML（RelativeSource版本）

<UserControl x:Class="WpfApp.MyTextBox"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:WpfApp">
    <Grid>
        <TextBox Text="{Binding MyText, RelativeSource={RelativeSource AncestorType={x:Type local:MyTextBox}}}" />
    </Grid>
</UserControl>

MainWindow XAML

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:WpfApp"
        Title="MainWindow" Height="450" Width="800">
    <Window.DataContext>
        <local:MainViewModel />
    </Window.DataContext>
    <StackPanel>
        <local:MyTextBox MyText="{Binding Name}" />
        <!-- 可添加原生TextBox验证绑定有效性 -->
        <TextBox Text="{Binding Name, UpdateSourceTrigger=PropertyChanged}" Margin="0,10,0,0" />
    </StackPanel>
</Window>

ViewModel示例（需实现INotifyPropertyChanged）

using System.ComponentModel;
using System.Runtime.CompilerServices;

namespace WpfApp
{
    public class MainViewModel : INotifyPropertyChanged
    {
        private string _name;
        public string Name
        {
            get => _name;
            set
            {
                _name = value;
                OnPropertyChanged();
            }
        }

        public event PropertyChangedEventHandler PropertyChanged;
        protected void OnPropertyChanged([CallerMemberName] string propertyName = null)
        {
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
        }
    }
}

验证效果 #

修改完成后，ViewModel的Name属性变化时，会同步到MyTextBox的MyText属性，进而更新内部TextBox的显示内容，绑定即可正常生效。

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