【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}}" />

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

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

我今天就遇到了 RelativeSource={RelativeSource TemplatedParent} 绑定不生效的问题，其原因有以下几个，其实就是上面表格中总结的：
TemplateBinding 在 WPF 中不支持真正的双向绑定。它的行为是单向的，只能从模板化父元素（应用模板的控件）向模板内部传递值。

TemplateBinding 的限制及好处

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

为什么 TemplateBinding 不支持双向

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

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

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

TemplateBinding 和 Binding 绑定源的区别

1 TemplateBinding

单向绑定，只能在控件模板（如ControlTemplate或DataTemplate）中使用。
绑定源固定为模板的目标控件（即应用该模板的控件实例）。
例如，在Button的模板中使用TemplateBinding Content，绑定的是该Button自身的Content属性。

2 Binding

可在任何地方使用。
绑定源可以是：
控件自身（通过RelativeSource Self）。
逻辑树中的父控件（通过RelativeSource AncestorType）。
数据上下文（DataContext）。
元素名称（ElementName）。
静态资源（StaticResource）等。

🧪 六、小结

• 如果你开发的是 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设置属性。这篇文章主要介绍如何在自定义模板的时候，如何使用依赖属性，避免踩坑。