WPF附加属性是允许一个类定义、其他类实例使用的特殊依赖属性，如Grid.Row；区别在于普通依赖属性仅限定义类及其派生类使用，而附加属性可被任意DependencyObject消费，且必须通过public static Get/Set方法访问。
什么是 WPF 附加属性，和普通依赖属性有什么区别
附加属性（Attached Property）是 WPF 中一种特殊的依赖属性，它允许一个类定义属性，但被其他类的实例“附加”使用。最典型的例子是 Grid.Row、Canvas.Left —— 它们由 Grid 或 Canvas 类定义，却设置在子元素上（比如 Button）。
关键区别在于：
- 普通依赖属性只能在定义它的类及其派生类上使用；
- 附加属性可以被任意
DependencyObject子类“消费”，只要它支持依赖属性系统； - 必须通过静态
GetXXX和SetXXX方法访问（不能直接点语法），这是编译器强制的约束。
如何用 C# 正确声明一个 Attached Property
声明附加属性需要三步，缺一不可，顺序也不能乱：
- 调用
DependencyProperty.RegisterAttached注册属性，返回DependencyProperty静态字段； - 提供公开的静态
GetXXX方法，参数为DependencyObject，返回值类型要匹配注册时的propertyType； - 提供公开的静态
SetXXX方法，第一个参数为DependencyObject，第二个为新值；
public static class ButtonHelper
{
public static readonly DependencyProperty IsLoadingProperty =
DependencyProperty.RegisterAttached(
"IsLoading",
typeof(bool),
typeof(ButtonHelper),
new PropertyMetadata(false));
<pre class="brush:php;toolbar:false;">public static bool GetIsLoading(DependencyObject obj) =>
(bool)obj.GetValue(IsLoadingProperty);
public static void SetIsLoading(DependencyObject obj, bool value) =>
obj.SetValue(IsLoadingProperty, value);}
⚠️ 常见错误：
- 忘记将
GetXXX/SetXXX声明为public static； -
RegisterAttached的第三个参数写成使用方类型（如typeof(Button)），其实应写定义方类型（即typeof(ButtonHelper)）； - 在 XAML 中拼错属性名（比如写成
local:ButtonHelper.Isloading，首字母小写会失败）。
在 XAML 和代码中怎么使用附加属性
XAML 中使用格式固定：NamespacePrefix:ClassName.PropertyName，前提是已正确声明 XML 命名空间（如 xmlns:local="clr-namespace:MyApp"）：
<Button local:ButtonHelper.IsLoading="True" />
C# 中必须用 GetXXX/SetXXX 方法，不能写 button.IsLoading = true（编译不过）：
ButtonHelper.SetIsLoading(myButton, true); bool isLoading = ButtonHelper.GetIsLoading(myButton);
注意：
- 如果目标对象不是
DependencyObject子类（比如普通object），调用GetValue会抛出InvalidOperationException； - 属性变更不会自动触发 UI 更新，除非你在回调中手动处理（比如绑定到控件状态）；
- 若需响应值变化，可在
PropertyMetadata中传入回调函数，但该回调的sender是设置属性的对象（即 Button），不是定义类（ButtonHelper）。
附加属性的典型用途和容易忽略的细节
常见用途包括：
- 向控件注入行为（如拖拽支持、加载状态、焦点管理）；
- 实现 MVVM 中的“伪绑定”逻辑（比如让某个 ViewModel 控制按钮是否禁用）；
- 替代模板/样式中难以表达的动态逻辑（比如根据数据源决定某列是否可编辑）；
容易被忽略的点：
- 附加属性不继承 —— 父元素设了
local:Helper.Flag="True"，子元素不会自动获得该值； - 不支持
Binding的RelativeSource FindAncestor直接绑定到附加属性本身（得靠MultiBinding或转换器绕过）； - 如果注册时没指定默认值，且未在 XAML 中显式设置，读取时可能得到
default(T)（比如bool是false），而不是null； - 在自定义控件模板中使用时，确保模板内的元素也支持该附加属性（即它们是
DependencyObject）。
附加属性不是语法糖，它是 WPF 属性系统底层机制的一部分 —— 写错一个参数或访问方式，轻则绑定失效，重则运行时报错，而且堆栈里往往不提示你哪行 XAML 出的问题。
