WPF的依赖与附加属性

核心关系：附加属性 ≈ 特殊的依赖属性

在 WPF 中，附加属性（Attached Property）是依赖属性（Dependency Property）的一种特殊实现 ------ 所有附加属性都是依赖属性，但依赖属性不一定是附加属性。

用通俗比喻理解：

• 依赖属性：「自家的属性」------ 定义在某个类中，仅（主要）供这个类自己使用（比如 Button 的 Content 属性、你之前问过的自定义 Count 属性）；
• 附加属性：「共享的属性」------ 定义在类 A 中，但可以 "附加" 到任意其他 WPF 元素（类 B、C、D）上使用（比如 Grid 的 Row/Column 属性，附加到 Button、TextBox 上，用来指定控件在 Grid 中的位置）。

---

一、先回顾：依赖属性（DependencyProperty）

核心特征

1. 属于定义它的类，是该类的 "固有属性"；
2. 基于 WPF 属性系统（而非普通 CLR 属性的字段 + get/set），支持数据绑定、样式、动画、属性继承等核心特性；
3. 定义时用 DependencyProperty.Register() 方法。

极简示例（自定义依赖属性）

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

// 自定义按钮：自带Count依赖属性（自家属性）
public class MyCountButton : Button
{
    // 1. 定义依赖属性（核心）
    public static readonly DependencyProperty CountProperty =
        DependencyProperty.Register(
            "Count",                  // 对外暴露的属性名
            typeof(int),              // 属性类型
            typeof(MyCountButton),    // 归属类（只能给MyCountButton用）
            new PropertyMetadata(0)   // 元数据：默认值0
        );

    // 2. CLR包装器（方便代码调用，非必须但推荐）
    public int Count
    {
        get => (int)GetValue(CountProperty);
        set => SetValue(CountProperty, value);
    }
}

XAML 使用方式

<!-- Count是MyCountButton自己的属性，直接赋值 -->
<local:MyCountButton Count="5" Content="计数按钮"/>

---

二、附加属性（Attached Property）

核心特征

1. 归属类和使用类分离：比如 Grid 定义了 Row 属性，但 Row 是给 Button、TextBox 等 Grid 的子元素用的；
2. 本质是依赖属性，继承了依赖属性的所有特性（绑定、样式、元数据等）；
3. 定义时用 DependencyProperty.RegisterAttached() 方法；
4. 必须提供静态的 SetXxx() 和 GetXxx() 方法（WPF 系统会通过这两个方法读写属性值）。

典型场景

• 布局相关：Grid.Row/Column、Canvas.Left/Top、DockPanel.Dock（布局容器定义属性，给子元素设置布局规则）；
• 行为扩展：Validation.ErrorTemplate（验证系统给输入控件附加验证模板）；
• 自定义扩展：给任意控件附加 "提示文本""是否可拖拽" 等通用属性。

完整示例：自定义附加属性

需求：定义一个TooltipHelper类，里面包含附加属性TipText，可以附加到任意 WPF 控件上，自动设置控件的 Tooltip。

using System.Windows;

// 附加属性的定义类（通常为静态类）
public static class TooltipHelper
{
    // 1. 定义附加属性（核心：RegisterAttached）
    public static readonly DependencyProperty TipTextProperty =
        DependencyProperty.RegisterAttached(
            "TipText",                // 附加属性名
            typeof(string),           // 属性类型
            typeof(TooltipHelper),    // 归属类（定义属性的类）
            // 元数据：值变更时自动绑定到控件的Tooltip
            new PropertyMetadata(
                string.Empty,         // 默认值
                OnTipTextChanged      // 值变更回调
            )
        );

    // 2. 静态Set方法（必须）：给目标元素设置附加属性值
    public static void SetTipText(DependencyObject obj, string value)
    {
        obj.SetValue(TipTextProperty, value);
    }

    // 3. 静态Get方法（必须）：获取目标元素的附加属性值
    public static string GetTipText(DependencyObject obj)
    {
        return (string)obj.GetValue(TipTextProperty);
    }

    // 4. 属性变更回调：自动给控件设置Tooltip
    private static void OnTipTextChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        // d是附加了该属性的目标控件（比如Button、TextBox）
        if (d is FrameworkElement element)
        {
            element.ToolTip = e.NewValue.ToString(); // 绑定Tooltip
        }
    }
}

使用方式（XAML + 代码）

1. XAML 中使用（最常见）

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:WpfApp"
        Title="附加属性示例" Height="300" Width="400">
    <StackPanel Margin="20">
        <!-- 给Button附加TooltipHelper.TipText属性 -->
        <Button Content="点击我" 
                local:TooltipHelper.TipText="这是自定义提示文本"
                Width="100" Height="30" Margin="5"/>

        <!-- 给TextBox附加TooltipHelper.TipText属性 -->
        <TextBox PlaceholderText="输入内容"
                 local:TooltipHelper.TipText="请输入手机号"
                 Width="200" Height="30" Margin="5"/>

        <!-- 给Grid附加TooltipHelper.TipText（任意控件都可以） -->
        <Grid local:TooltipHelper.TipText="这是网格容器"
              Height="50" Background="LightGray" Margin="5"/>
    </StackPanel>
</Window>

2. 代码中使用附加属性

// 给Button设置附加属性值
Button btn = new Button();
TooltipHelper.SetTipText(btn, "代码设置的提示");

// 获取Button的附加属性值
string tip = TooltipHelper.GetTipText(btn);

运行效果

鼠标悬停在 Button/TextBox/Grid 上时，会自动显示对应的提示文本 ------ 这就是附加属性的核心价值：让一个类定义的属性，能给任意 WPF 元素 "附加" 通用功能。

---

三、依赖属性 vs 附加属性（核心区别）

表格

维度	依赖属性（DependencyProperty）	附加属性（Attached Property）
定义方法	Register()	RegisterAttached()
归属与使用	定义类 = 使用类（自家属性）	定义类 ≠ 使用类（共享属性）
访问方式	直接通过 CLR 包装器（如btn.Count）	通过静态 Set/Get 方法（如SetTipText）
核心场景	自定义控件的固有属性	布局、通用行为扩展（跨控件）
典型示例	Button.Content、MyCountButton.Count	Grid.Row、Canvas.Left、自定义 TipText

---

总结

1. 附加属性是特殊的依赖属性，继承了依赖属性的所有核心特性（绑定、样式、元数据等）；
2. 依赖属性是 "自家属性"（定义类自用），附加属性是 "共享属性"（定义类给其他控件扩展功能）；
3. 附加属性定义需用RegisterAttached()，并提供静态SetXxx/GetXxx方法，核心用于布局或跨控件的通用功能扩展。