📦 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 的限制及好處
- 單向綁定：默認情況下只支持從模板父元素到模板內部控件的單向綁定
- 不支持轉換器：不能像常規綁定那樣使用值轉換器
- 輕量級：比常規綁定性能更高，但功能更有限
為什么 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設置屬性。這篇文章主要介紹如何在自定義模板的時候，如何使用依賴屬性，避免踩坑。
)
