绑定到用户控件的依赖属性——WPF简单控件技术咨询

没问题，我来一步步教你搞定这个绑定。核心思路就是先在用户控件后台定义合规的依赖属性，再把内部元素和这个属性关联起来，最后就能像用原生控件一样在外层绑定数据了。

第一步：在后台代码定义依赖属性 #

打开你的TextBlockUC.xaml.cs文件，添加以下代码。我们以绑定文本内容为例，定义一个名为Text的依赖属性——这是WPF实现自定义控件属性绑定的关键：

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

namespace WpfUserControls.Controls
{
    public partial class TextBlockUC : UserControl
    {
        public TextBlockUC()
        {
            InitializeComponent();
        }

        // 按照WPF约定，依赖属性命名为[属性名]Property
        public static readonly DependencyProperty TextProperty =
            DependencyProperty.Register(
                "Text", 
                typeof(string), 
                typeof(TextBlockUC), 
                new PropertyMetadata(string.Empty) // 设置默认值为空字符串
            );

        // CLR包装器，方便你在代码里直接访问这个属性
        public string Text
        {
            get { return (string)GetValue(TextProperty); }
            set { SetValue(TextProperty, value); }
        }
    }
}

这里要注意：依赖属性的命名规则必须遵守，不然绑定会出问题；如果需要在属性值变化时触发自定义逻辑，还可以给PropertyMetadata加个回调方法（后面会提）。

第二步：在用户控件XAML中绑定内部元素 #

回到你的TextBlockUC.xaml，补全内部的TextBlock控件，把它的Text属性绑定到我们刚定义的依赖属性。这里有两种常用的绑定方式：

方式一：通过ElementName绑定（利用控件已有的Name）

因为你的用户控件已经设置了Name="TextBlockUserControl"，可以直接用这个名称绑定：

<UserControl x:Class="WpfUserControls.Controls.TextBlockUC"
             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:WpfUserControls.Controls"
             mc:Ignorable="d"
             d:DesignHeight="300" d:DesignWidth="300"
             Name="TextBlockUserControl">
    <Grid>
        <!-- 绑定到用户控件的Text依赖属性 -->
        <TextBlock Text="{Binding ElementName=TextBlockUserControl, Path=Text}" />
    </Grid>
</UserControl>

方式二：通过RelativeSource绑定（更通用，不依赖控件Name）

如果不想绑定控件的Name，用RelativeSource更灵活，适合控件复用场景：

<UserControl x:Class="WpfUserControls.Controls.TextBlockUC"
             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:WpfUserControls.Controls"
             mc:Ignorable="d"
             d:DesignHeight="300" d:DesignWidth="300">
    <Grid>
        <!-- 绑定到当前用户控件的Text依赖属性 -->
        <TextBlock Text="{Binding RelativeSource={RelativeSource AncestorType=UserControl}, Path=Text}" />
    </Grid>
</UserControl>

第三步：在父窗口/页面中使用并绑定数据 #

现在你可以像用原生控件一样，在其他地方使用这个用户控件，直接绑定数据到它的Text属性：

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:controls="clr-namespace:WpfUserControls.Controls"
        Title="MainWindow" Height="450" Width="800">
    <Grid>
        <!-- 绑定到ViewModel的属性 -->
        <controls:TextBlockUC Text="{Binding ViewModelText}" />
        <!-- 或者直接设置静态文本 -->
        <controls:TextBlockUC Text="这是测试文本" Margin="0,50,0,0" />
    </Grid>
</Window>

额外小提示 #

• 如果需要绑定其他类型的属性（比如字体大小、颜色），只需要按照同样的方式定义对应的依赖属性即可。
• 要是需要在属性值变化时执行逻辑，可以给PropertyMetadata加个回调方法，比如：

  public static readonly DependencyProperty TextProperty =
      DependencyProperty.Register(
          "Text", 
          typeof(string), 
          typeof(TextBlockUC), 
          new PropertyMetadata(string.Empty, OnTextChanged)
      );
  
  private static void OnTextChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
  {
      var control = d as TextBlockUC;
      if (control != null)
      {
          // 这里写属性变化后的逻辑，比如更新内部控件的其他状态
      }
  }
  

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