【WPF】 自定义控件中 依赖属性直接赋值导致绑定失效！

背景

最近在做一个基于 WPF 和 Halcon 的图像处理项目时，遇到了自定义控件中 HImage 依赖属性绑定失效问题。折腾了好久才彻底解决。
问题的起源：一个简单的图像显示需求
我需要做一个自定义图像显示控件，核心功能是加载本地图片并显示。于是定义了一个 CurImg 的依赖属性，类型是 Halcon 的 HImage，用于存储当前显示的图像对象。代码大概是这样的：

上一篇博客中有提到整个自定义的过程！

public HObject CurImg
{
    get { return (HObject)GetValue(CurImgProperty); }
    set { SetValue(CurImgProperty, value); }
}

public static readonly DependencyProperty CurImgProperty =
    DependencyProperty.Register("CurImg", typeof(HObject), typeof(ImageView), new PropertyMetadata(ImageChangedCallBack));

然后写了一个 ShowImage 方法用于加载并显示图像：

private void ShowImage(string path)
{
    if (!System.IO.File.Exists(path))
    {
        throw new Exception($"不存在路径 {path}");
    }
    window.ClearWindow();
    window.DetachBackgroundFromWindow();
    CurImg?.Dispose();
    CurImg = new HImage(path);
    HOperatorSet.GetImageSize(CurImg, out imageWidth, out imageHeight);
    HOperatorSet.AttachBackgroundToWindow(CurImg, hSmart?.HalconWindow);
}

一开始使用起来没什么问题，但当我尝试在 XAML 中给 CurImg 绑定一个 ViewModel 的属性时，怪事发生了 - 绑定总是失效，ViewModel 里的属性变化后，控件根本没反应。
排查过程：绑定为什么会失效？
我首先检查了绑定代码，确保绑定路径正确，ViewModel 也确实实现了 INotifyPropertyChanged 接口。但无论怎么调试，控件的 CurImg 属性就是不响应源属性的变化。
后来查阅 WPF 依赖属性的文档才明白：依赖属性有严格的值优先级体系。当我在 ShowImage 方法中直接给 CurImg 赋值（CurImg = new HImage(path)）时，其实是设置了一个 “本地值”，而本地值的优先级高于绑定值。这就导致了外部绑定被覆盖，看起来像是 “失效” 了。
简单说就是：WPF 会优先使用我在控件内部设置的本地值，而忽略了来自绑定的更新。

解决方案

解决绑定问题：用 SetCurrentValue 替代直接赋值
知道了问题根源后，解决方法就清晰了。WPF 提供了SetCurrentValue方法，它可以在不设置本地值的情况下更新依赖属性，从而不会覆盖绑定。
修改 ShowImage 方法中的赋值部分：

// 原来的写法，会设置本地值覆盖绑定
// CurImg = new HImage(path);

// 新的写法，保留绑定的同时更新值
var newImage = new HImage(path);
SetCurrentValue(CurImgProperty, newImage);

这样修改后，外部绑定果然恢复了正常 - 无论是控件内部更新还是源属性变化，CurImg 都能正确响应了。

注意问题：HImage 需要主动释放吗？

解决了绑定问题，又一个疑问浮现：newImage作为 HImage 对象，需要手动释放吗？
Halcon 的文档明确说明（也根据我的经验）：HObject（包括 HImage）封装了非托管资源，必须手动调用 Dispose () 释放，否则会导致内存泄漏。因为这些非托管资源不受.NET 垃圾回收器管理，不主动释放的话，即使对象被回收，资源也会一直占用。
在我的代码中，其实已经有了CurImg?.Dispose();这样的释放逻辑，但还需要注意：
释放时机：必须在创建新对象前释放旧对象
释放完整性：不仅切换图像时要释放，控件销毁时也要确保最终释放
完善后的资源管理代码：

private void ShowImage(string path)
{
    if (!System.IO.File.Exists(path))
    {
        throw new Exception($"不存在路径 {path}");
    }
    window.ClearWindow();
    window.DetachBackgroundFromWindow();
    
    // 先释放旧图像资源
    if (CurImg != null && CurImg.IsInitialized())
    {
        CurImg.Dispose();
    }
    
    // 创建新图像并使用SetCurrentValue更新
    var newImage = new HImage(path);
    SetCurrentValue(CurImgProperty, newImage);
    
    HOperatorSet.GetImageSize(newImage, out imageWidth, out imageHeight);
    HOperatorSet.AttachBackgroundToWindow(newImage, hSmart?.HalconWindow);
}

// 控件销毁时的最终释放
protected override void OnUnloaded(RoutedEventArgs e)
{
    base.OnUnloaded(e);
    if (CurImg != null && CurImg.IsInitialized())
    {
        CurImg.Dispose();
    }
}

总结

自定义控件中使用依赖属性的注意事项
这次经历让我对 WPF 依赖属性有了更深入的理解，总结几点经验：
慎用直接赋值：在控件内部更新依赖属性时，优先使用SetCurrentValue而非直接赋值，避免覆盖外部绑定
理解值优先级：WPF 依赖属性的值优先级从高到低为：本地值 > 绑定 > 样式 > 默认值
非托管资源必须释放：对于封装非托管资源的对象（如 HImage），务必在适当的时机调用 Dispose ()
释放时机很重要：替换对象前释放旧资源，控件销毁时确保最终释放，避免内存泄漏
通过这些调整，我的自定义图像控件终于既能正常响应外部绑定，又能安全地管理图像资源了。
希望这些经验能帮到同样在 WPF+Halcon 开发中遇到类似问题的朋友。