WPF实现ICommand类型鼠标悬停附加属性绑定报错解决问询

问题场景 #

需为WPF按钮实现检测鼠标悬停状态自动触发执行的ICommand类型附加属性，实现代码与调用代码如下：

C#附加属性实现代码 #

public class MouseMovement 
    {
        public static readonly DependencyProperty MouseOverCommandProperty =
            DependencyProperty.RegisterAttached("MouseOverCommand", typeof(ICommand), typeof(MouseMovement), 
                new FrameworkPropertyMetadata(new PropertyChangedCallback(MouseOverCommandChanged)));

        private static void MouseOverCommandChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
        {
            FrameworkElement element = (FrameworkElement)d;
            element.MouseEnter += new MouseEventHandler(element_MouseOver);
        }

        private static void element_MouseOver(object sender, MouseEventArgs e)
        {
            FrameworkElement element = (FrameworkElement)sender;
            ICommand cmd = GetMouseOverCommand(element);
            cmd.Execute(e);
        }

        public static void SetMouseOverCommand(UIElement element, ICommand value)
        {
            element.SetValue(MouseOverCommandProperty, value);
        }

        private static ICommand GetMouseOverCommand(FrameworkElement element)
        {
            return (ICommand)element.GetValue(MouseOverCommandProperty);
        }
}

XAML调用代码 #

<Button mouseEvents:MouseMovement.MouseOverCommand="{Binding ButtonMouseOverCommand}"  Grid.Row="0" Background="Transparent" BorderThickness="0" >
    <StackPanel>
        <Image />
        <TextBlock Text="BL-Invoices" Foreground="White"/>
    </StackPanel>
</Button>

运行时抛出以下错误：

"Binding can not be specified for the property "SetMouseOverCommand" of type button. Binding can only be specified for a DependencyProperty of a DependencyObject"

通用排查步骤 #

• 检查附加属性注册名与Get/Set方法后缀的一致性：WPF附加属性要求RegisterAttached方法第一个参数传入的属性名，必须和GetXXX、SetXXX方法名中的XXX完全一致，大小写也需要匹配，否则XAML解析器无法将属性引用关联到对应的依赖属性，会尝试直接绑定到Set方法，抛出不支持绑定的错误。
• 检查Get/Set方法的参数类型：建议Get方法的输入参数、Set方法的第一个参数统一为DependencyObject类型，避免因参数类型不匹配导致解析失败。
• 检查XAML命名空间映射：确认XAML头部声明的mouseEvents前缀对应的CLR命名空间，与MouseMovement类所在的命名空间完全一致，无拼写错误。
• 检查依赖属性字段的访问修饰符：附加属性对应的静态DependencyProperty字段必须为public readonly，不能设置为非公开的访问级别，否则XAML解析器无法访问到该依赖属性。
• 检查绑定源的命令属性：确认ViewModel中存在公开的ButtonMouseOverCommand属性，且属性类型为ICommand，已完成初始化赋值。

本次问题根因 #

注册附加属性时出现拼写失误，RegisterAttached方法第一个参数误写为MouveOverCommand，与GetMouseOverCommand、SetMouseOverCommand方法的后缀MouseOverCommand不匹配，导致XAML解析错误。上述给出的代码片段已修正该拼写问题，可直接正常运行。

内容的提问来源于stack exchange，提问作者VR46_Italia