dependencyproperty 必须用 static readonly 声明，因其是类型级资源，需供wpf属性系统通过反射查找注册；非static或非readonly会导致重复注册、内存泄漏或invalidoperationexception。
为什么 DependencyProperty 必须用 static readonly 声明
因为 DependencyProperty 是类型级资源，不是实例级变量。WPF 的属性系统在运行时通过类型反射查找 static 字段来注册和解析属性；如果声明为实例字段或非 readonly，会导致多次注册冲突、内存泄漏或 InvalidOperationException: "The property is already registered to another owner"。
实操建议：
- 所有
DependencyProperty字段必须声明为public static readonly DependencyProperty - 注册时传入的 owner type 必须是当前类（不能写基类或
typeof(DependencyObject)） - 命名规范：字段名 = 属性名 +
Property后缀（如TextProperty），否则GetText()/SetText()等包装方法会失效
如何正确实现 CLR 包装器（get/set）
CLR 包装器不是可选的“语法糖”，而是 WPF 数据绑定、样式触发器、动画等机制调用的入口。它必须严格遵循模式：get 调用 GetValue()，set 调用 SetValue()，且不能加任何逻辑（比如空值校验、转换、事件通知）——这些该交给回调函数。
常见错误现象：
- 绑定到自定义控件属性后值不更新 → 包装器里写了
if (value != _field) { ... }手动缓存 - 触发器无法响应属性变化 → set 里调用了
OnPropertyChanged()或手动 raise 事件 - 动画报错
"Cannot animate the 'XXX' property on a 'YYY' using a 'DoubleAnimation'"→ 包装器类型与注册时的propertyType不一致（比如注册为int，但包装器 get 返回int?）
正确示例（以 Text 属性为例）：
public static readonly DependencyProperty TextProperty =
DependencyProperty.Register(
nameof(Text),
typeof(string),
typeof(MyCustomControl),
new PropertyMetadata(string.Empty));
<p>public string Text
{
get => (string)GetValue(TextProperty);
set => SetValue(TextProperty, value);
}</p>
Callback 函数里能做什么、不能做什么
PropertyChangedCallback 是属性值真正变更后的唯一可靠时机，但它运行在 WPF 属性系统内部，**不是 UI 线程保证的上下文，也不在控件生命周期安全区**。它适合做轻量同步响应（如刷新内部状态），不适合做 UI 更新、异步操作或引发新属性变更。
实操建议：
- ✅ 可以：更新内部缓存字段、调用
InvalidateVisual()、检查值合法性并抛出ArgumentException - ❌ 禁止：调用
Dispatcher.Invoke（除非明确需要跨线程）、在回调里再调用SetValue()同一属性（会死循环）、访问this.Children等未初始化的 UI 树成员 - ⚠️ 注意：回调参数中的
oldValue/newValue是原始值，不是经过转换器处理后的结果；若注册了CoerceValueCallback，它会在PropertyChangedCallback之前执行
为什么 CoerceValueCallback 和 ValidateValueCallback 容易被忽略
这两个回调才是控制属性合法边界的核心。没有 ValidateValueCallback，非法值（比如把 double 设成 NaN 或 Infinity）可能静默通过，直到渲染时报错；没有 CoerceValueCallback，就无法实现“依赖约束”——比如 MaxWidth 变化时自动限制 Width 不超限。
使用场景举例：
-
ValidateValueCallback：确保FontSize> 0，或字符串长度 ≤ 100 -
CoerceValueCallback：当IsEnabled为false时，强制Opacity不低于 0.3；或让ColumnIndex自动 clamp 在0到ColumnDefinitions.Count - 1之间
关键点：两个回调都必须是 static 方法，且返回 bool（validate）或 coerced 值（coerce）；它们在属性系统底层拦截，比包装器更早介入流程。
最常被绕过的其实是 coerce 逻辑 —— 很多人只靠 set 包装器做校验，但那样无法约束样式、模板、动画设来的值，而 coerce 对所有来源都生效。
