迁移WPF至.NET Core3.1时派生UserControl出现命名空间不存在错误

问题场景 #

在VS2019/Windows 11环境下，将C# WPF应用从.NET Framework 4.8迁移至.NET Core 3.1后，构建时出现如下错误：

Error XDG0008 The name "UserControlBase" does not exist in the namespace "clr-namespace:WpfApp2". WpfApp2 \UserControl2.xaml Line 1

问题出在继承自定义基类UserControlBase的用户控件上，相关代码示例如下：

XAML代码：

<local:UserControlBase x:Class="WpfApp2.UserControl2"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
             xmlns:local="clr-namespace:WpfApp2"
             mc:Ignorable="d" 
             d:DesignHeight="450" d:DesignWidth="800">
    <Grid>
            
    </Grid>
</local:UserControlBase>

自定义基类代码：

namespace WpfApp2
{
    public class UserControlBase : UserControl
    {
    }
}

项目文件配置：

<Project Sdk="Microsoft.NET.Sdk.WindowsDesktop">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>netcoreapp3.1</TargetFramework>
    <UseWPF>true</UseWPF>
  </PropertyGroup>
</Project>

直接继承UserControl的用户控件可正常编译，而该自定义基类是实现工厂模式的核心依赖，必须解决此问题。

解决办法 #

• 检查基类文件的编译属性
  右键UserControlBase.cs文件，打开“属性”面板，确认“生成操作”设置为编译，确保文件被正确纳入编译流程。

• 显式指定命名空间的程序集
  .NET Core WPF的XAML命名空间解析逻辑与.NET Framework略有差异，即使是同一程序集，有时需要显式声明程序集名称。修改XAML中的local命名空间声明：

  xmlns:local="clr-namespace:WpfApp2;assembly=WpfApp2"
  

  其中assembly=WpfApp2替换为你的项目实际程序集名称（通常与项目名称一致）。

• 彻底清理并重建项目

  1. 点击菜单“生成”->“清理解决方案”
  2. 手动删除项目目录下的bin和obj文件夹
  3. 重新生成解决方案，避免旧编译缓存导致的解析异常

• 验证代码后置类的继承关系
  确保UserControl2的代码后置类正确继承自UserControlBase，且构造函数中调用InitializeComponent()：

  public partial class UserControl2 : UserControlBase
  {
      public UserControl2()
      {
          InitializeComponent();
      }
  }
  

  同时检查XAML中的x:Class属性值与代码类的命名空间+类名完全匹配。

• 更新VS2019到最新版本
  VS2019早期版本对.NET Core 3.1的XAML解析存在部分已知bug，安装最新补丁后可修复此类命名空间解析问题。

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