📦 WPF 自定义控件之依赖属性
在开发 WPF 应用时，自定义控件能帮助我们复用逻辑和样式，但我很快会遇到一个问题：在控件内部如何支持数据绑定和属性变更通知？特别是我们继承自 Control 的时候，已经不能再继承 BindableBase 了，这就聊聊依赖属性机制。
🧩 一、为什么使用依赖属性？
在 MVVM 架构中，我们通常使用 BindableBase 或类似类提供的 INotifyPropertyChanged 实现属性通知。但当你开发一个自定义控件，比如从 Control、Button、ItemsControl 等继承时：
你不能再继承 BindableBase。
控件的属性需要支持样式设置、动画、绑定、默认值等特性。
这时就试试 依赖属性（DependencyProperty）。毕竟依赖属性天然支持绑定（只是写起来毕竟麻烦。。。）
✅ 依赖属性的优势：
支持样式系统
支持数据绑定
支持动画（如 Storyboard）
支持属性值继承
提供更强大的性能优化（例如内存占用更低）
🛠️ 二、如何在自定义控件中定义依赖属性？
我们以一个自定义控件 ImageMessageControl 为例，它有一个 ImageMessage 属性，用于显示一段提示文字。
💡 Step 1：继承 Control 类
csharp
复制代码
public class ImageMessageControl : Control
{
static ImageMessageControl()
{
DefaultStyleKeyProperty.OverrideMetadata(typeof(ImageMessageControl), new FrameworkPropertyMetadata(typeof(ImageMessageControl)));
}
public string ImageMessage
{
get { return (string)GetValue(ImageMessageProperty); }
set { SetValue(ImageMessageProperty, value); }
}
public static readonly DependencyProperty ImageMessageProperty =
DependencyProperty.Register(
nameof(ImageMessage),
typeof(string),
typeof(ImageMessageControl),
new PropertyMetadata(string.Empty));
}
🧵 三、在模板中绑定依赖属性
控件模板是通过 Generic.xaml 定义的，我们如何让模板里的 TextBlock 绑定到这个 ImageMessage 属性？
有两种常见方式：
✅ 方法一：使用 TemplateBinding（简洁）
xml
复制代码
✅ 方法二：使用 Binding + RelativeSource
xml
复制代码
⚖️ 四、两种绑定方式的区别
比较项
TemplateBinding
Binding RelativeSource=TemplatedParent
简洁性
✅ 简洁，语法短
❌ 稍显繁琐
支持的功能
❌ 不支持转换器、绑定模式、值转换器等
✅ 支持所有 Binding 功能
性能
✅ 性能更优（编译时优化）
❌ 性能略逊
可扩展性
❌ 功能有限
✅ 功能更强大
是否可能失败
少见（依赖于模板绑定）
❗ 更容易出错
🧨 五、为何 RelativeSource=TemplatedParent 有时绑定失败？
我今天就遇到了 RelativeSource={RelativeSource TemplatedParent} 绑定不生效的问题，其原因有以下几个，其实就是上面表格中总结的：
TemplateBinding 在 WPF 中不支持真正的双向绑定。它的行为是单向的，只能从模板化父元素（应用模板的控件）向模板内部传递值。
TemplateBinding 的限制及好处
单向绑定：默认情况下只支持从模板父元素到模板内部控件的单向绑定
不支持转换器：不能像常规绑定那样使用值转换器
轻量级：比常规绑定性能更高，但功能更有限
为什么 TemplateBinding 不支持双向
TemplateBinding 设计初衷是为了模板中的轻量级绑定场景，主要目的是将控件属性值应用到其模板中的可视化元素上。双向绑定需要更复杂的机制，所以被有意限制为单向。
如果您需要双向绑定功能，请使用 RelativeSource 结合 TemplatedParent 的常规 Binding 语法。
xml
复制代码
🧪 六、小结
如果你开发的是 UserControl，可以继续使用普通属性 + INotifyPropertyChanged。
如果你开发的是 自定义控件 （继承 Control 等），请使用依赖属性。
模板中绑定自身属性时：
用 TemplateBinding 性能好，适合简单场景；
用 Binding + RelativeSource 更灵活，适合复杂场景。
📌 推荐结构
控件文件夹结构建议如下：
复制代码
/Controls
└── ImageMessageControl.cs
/Themes
└── Generic.xaml
Generic.xaml 示例：
xml
复制代码
小结
其实依赖属性最大的用处还是，可以给前台暴露属性。方便我们通过XAML设置属性。这篇文章主要介绍如何在自定义模板的时候，如何使用依赖属性，避免踩坑。