使用XmlnsDefinition时自定义库控件遇XFC0000错误，如何解决？

问题背景 #

我希望发布一个带有XmlnsDefinition的NuGet控件库，为此制作了包含自定义ButtonEx控件的最小验证Demo：

[assembly: XmlnsDefinition("http://schemas.mycompany.com/concept", "ControlLibrary")]
[assembly: XmlnsPrefix("http://schemas.mycompany.com/concept", "concept")]

namespace ControlLibrary;
public partial class ButtonEx : Button
{
    public ButtonEx()
    {
        InitializeComponent();
    }
}

添加项目引用后，XAML智能感知能识别该控件，但编译时出现XFC0000错误——控件可被编译器识别却无法解析。已排除控件不存在的情况（若控件不存在会报XLS0414“未找到”错误）。请问：

1. 此XmlnsDefinition的用法是否正确？
2. 若用法正确，需补充什么配置才能让控件既可见又可解析？

解决方案 #

1. XmlnsDefinition用法正确性 #

你当前的XmlnsDefinition和XmlnsPrefix标记写法本身是正确的，它们的作用是将指定CLR命名空间映射到自定义XML命名空间，属于XAML控件库的标准配置方式。

2. 需补充的配置项 #

针对编译时XFC0000错误，需检查并补充以下配置：

• 确保控件库项目类型配置正确
  根据你使用的XAML框架（.NET MAUI/WPF等），在项目文件（.csproj）中设置正确的项目类型：

  • .NET MAUI控件库示例配置：

    <Project Sdk="Microsoft.NET.Sdk">
      <PropertyGroup>
        <TargetFramework>net7.0-android;net7.0-ios;net7.0-maccatalyst;net7.0-windows10.0.19041.0</TargetFramework>
        <UseMaui>true</UseMaui>
        <SingleProject>true</SingleProject>
        <ImplicitUsings>enable</ImplicitUsings>
      </PropertyGroup>
    </Project>
    

  • WPF控件库示例配置：

    <Project Sdk="Microsoft.NET.Sdk">
      <PropertyGroup>
        <TargetFramework>net6.0-windows</TargetFramework>
        <UseWPF>true</UseWPF>
      </PropertyGroup>
    </Project>
    

• 检查分部类的XAML文件配置
  ButtonEx作为分部类，对应的XAML文件（ButtonEx.xaml）需满足两个条件：

  • 文件的Build Action设置为Embedded Resource
  • XAML根节点的x:Class属性必须与CLR命名空间和类名完全匹配，示例：

    <Button xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
            xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
            x:Class="ControlLibrary.ButtonEx">
    </Button>
    

• 确保控件库已正确生成并引用
  重新生成控件库项目，确认输出目录生成了正确的程序集；在引用项目中，确保引用的是最新生成的程序集版本，而非旧缓存文件。

• 适配多目标框架的XmlnsDefinition生效
  若控件库支持多目标框架，需确保XmlnsDefinition标记对所有目标框架生效，可通过项目文件的条件配置或直接保证程序集属性在所有框架下均被编译。

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