WPF中为依赖属性赋值Page时类型不匹配错误排查

错误原因 #

这是Visual Studio WPF设计器的设计时类型冲突问题：你的自定义控件中AssociatedPage属性声明的Page类型，在设计阶段被Visual Studio内置的XSurface组件错误解析为它内部的Microsoft.VisualStudio.XSurface.Wpf.Page，而非你实际需要的System.Windows.Controls.Page，导致类型校验失败。

解决方案 #

1. 显式指定完整命名空间（核心解决方法） #

修改自定义控件的C#代码，给Page类型加上完整的命名空间限定，彻底消除类型歧义：

public class MyButton : Button
{
  static MyButton() {
    DefaultStyleKeyProperty.OverrideMetadata(typeof(MyButton), new FrameworkPropertyMetadata(typeof(MyButton)));
  }

  // 显式使用System.Windows.Controls.Page
  public System.Windows.Controls.Page AssociatedPage {
    get { return (System.Windows.Controls.Page)GetValue(AssociatedPageProperty); }
    set { SetValue(AssociatedPageProperty, value); }
  }

  public static readonly DependencyProperty AssociatedPageProperty =
      DependencyProperty.Register("AssociatedPage", typeof(System.Windows.Controls.Page), typeof(MyButton));
}

2. 调整XAML绑定写法（辅助修复） #

如果设计器仍有报错，可以换一种XAML写法，显式指定属性节点，帮助设计器正确识别类型：

<controls:MyButton Content="Home">
    <controls:MyButton.AssociatedPage>
        <StaticResource ResourceKey="HomePage" />
    </controls:MyButton.AssociatedPage>
</controls:MyButton>

3. 清理缓存并重建项目 #

设计器缓存可能残留错误类型信息，执行以下步骤：

• 点击菜单「项目」→「清理解决方案」
• 重新生成项目
• 重启Visual Studio，刷新设计器

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