MAUI页面继承自定义泛型基类报CS0263错误如何解决？

问题原因 #

MAUI会根据XAML文件的根节点类型自动生成分部类的父类，你两次写法都有问题：

1. 首次写法根节点是ContentPage，生成的分部类父类为ContentPage，和你手动指定的BaseContentPage<MainVm>冲突，触发CS0263错误
2. 第二次写法根节点直接写BaseContentPage，XAML默认会在MAUI官方命名空间下查找该类，找不到就会报未知类错误

解决方案 #

修正XAML写法 #

你需要在自定义基类前加上对应的命名空间前缀，同时保留x:TypeArguments指定泛型参数即可，正确的XAML示例如下：

<local:BaseContentPage 
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:m="clr-namespace:MyProject.Models"
    xmlns:vm="clr-namespace:MyProject.ViewModels"
    x:Class="MyProject.Pages.MainPage"
    x:TypeArguments="vm:MainVm"
    xmlns:local="clr-namespace:MyProject">
    <Content>
        <StackLayout>
            <Label Text="Welcome to MyProject!"
                VerticalOptions="CenterAndExpand" 
                HorizontalOptions="CenterAndExpand" />
        </StackLayout>
    </Content>
</local:BaseContentPage>

注意事项 #

• 确保BaseContentPage所在的命名空间和xmlns:local定义的命名空间一致，如果基类放在单独的子命名空间，需要单独声明前缀再使用
• 改完后先清理项目，再重新生成，避免XAML缓存导致的错误提示
• 不需要手动修改生成的隐藏代码，XAML根节点改对后，生成的分部类会自动继承local:BaseContentPage<vm:MainVm>，和你手动写的分部类父类保持一致

备选方案（泛型基类兼容异常时使用） #

如果遇到低版本MAUI对泛型基类支持异常，可以额外加一层非泛型的中间基类过渡，泛型逻辑放在后台代码实现，高版本MAUI已经完全支持泛型基类的XAML声明，一般不需要该操作。

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