【WPF】WPF 自定义控件之依赖属性

📦 WPF 自定义控件之依赖属性

在开发 WPF 应用时，自定义控件能帮助我们复用逻辑和样式，但我很快会遇到一个问题：在控件内部如何支持数据绑定和属性变更通知？特别是我们继承自 Control 的时候，已经不能再继承 BindableBase 了，这就聊聊依赖属性机制。

---

🧩 一、为什么使用依赖属性？

在 MVVM 架构中，我们通常使用 BindableBase 或类似类提供的 INotifyPropertyChanged 实现属性通知。但当你开发一个自定义控件，比如从 Control、Button、ItemsControl 等继承时：

• 你不能再继承 BindableBase。
• 控件的属性需要支持样式设置、动画、绑定、默认值等特性。

这时就试试 依赖属性（DependencyProperty）。毕竟依赖属性天然支持绑定（只是写起来毕竟麻烦。。。）

✅ 依赖属性的优势：

• 支持样式系统
• 支持数据绑定
• 支持动画（如 Storyboard）
• 支持属性值继承
• 提供更强大的性能优化（例如内存占用更低）

---

🛠️ 二、如何在自定义控件中定义依赖属性？

我们以一个自定义控件 ImageMessageControl 为例，它有一个 ImageMessage 属性，用于显示一段提示文字。

💡 Step 1：继承 Control 类

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（简洁）

<TextBlock Text="{TemplateBinding ImageMessage}" />

✅ 方法二：使用 Binding + RelativeSource

<TextBlock Text="{Binding Path=ImageMessage, RelativeSource={RelativeSource TemplatedParent}}" />

---

⚖️ 四、两种绑定方式的区别

比较项	TemplateBinding	Binding RelativeSource=TemplatedParent
简洁性	✅ 简洁，语法短	❌ 稍显繁琐
支持的功能	❌ 不支持转换器、绑定模式、值转换器等	✅ 支持所有 Binding 功能
性能	✅ 性能更优（编译时优化）	❌ 性能略逊
可扩展性	❌ 功能有限	✅ 功能更强大
是否可能失败	少见（依赖于模板绑定）	❗ 更容易出错

---

🧨 五、为何 RelativeSource=TemplatedParent 有时绑定失败？

我今天就遇到了 RelativeSource={RelativeSource TemplatedParent} 绑定不生效的问题，其原因有以下几个，其实就是上面表格中总结的：

TemplateBinding 在 WPF 中不支持真正的双向绑定。它的行为是单向的，只能从模板化父元素（应用模板的控件）向模板内部传递值。

TemplateBinding 的限制及好处

1. 单向绑定：默认情况下只支持从模板父元素到模板内部控件的单向绑定
2. 不支持转换器：不能像常规绑定那样使用值转换器
3. 轻量级：比常规绑定性能更高，但功能更有限

为什么 TemplateBinding 不支持双向

TemplateBinding 设计初衷是为了模板中的轻量级绑定场景，主要目的是将控件属性值应用到其模板中的可视化元素上。双向绑定需要更复杂的机制，所以被有意限制为单向。

如果您需要双向绑定功能，请使用 RelativeSource 结合 TemplatedParent 的常规 Binding 语法。

<TextBlock Text="{Binding Path=ImageMessage, RelativeSource={RelativeSource TemplatedParent}}" />

---

🧪 六、小结

• 如果你开发的是 UserControl，可以继续使用普通属性 + INotifyPropertyChanged。

• 如果你开发的是 自定义控件 （继承 Control 等），请使用依赖属性。

• 模板中绑定自身属性时：

  • 用 TemplateBinding 性能好，适合简单场景；
  • 用 Binding + RelativeSource 更灵活，适合复杂场景。

---

📌 推荐结构

控件文件夹结构建议如下：

/Controls
  └── ImageMessageControl.cs
/Themes
  └── Generic.xaml

Generic.xaml 示例：

<Style TargetType="{x:Type local:ImageMessageControl}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:ImageMessageControl}">
                <Border BorderBrush="Gray" BorderThickness="1" Padding="4">
                    <TextBlock Text="{TemplateBinding ImageMessage}" />
                </Border>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

小结

其实依赖属性最大的用处还是，可以给前台暴露属性。方便我们通过XAML设置属性。这篇文章主要介绍如何在自定义模板的时候，如何使用依赖属性，避免踩坑。