如何在.NET MAUI中为泛型类型配置x:DataType？

正确写法 #

在XAML中指定泛型类型的x:DataType，需要使用反引号标识泛型参数数量，再通过TypeArguments指定具体的泛型参数类型，示例代码如下：

<DataTemplate x:DataType="{x:Type m:SelectionItem`1, TypeArguments={x:Type e:Message}}">
    <!-- 此处可正常绑定Item.Subject并获得智能提示 -->
    <Label Text="{Binding Item.Subject}" />
</DataTemplate>

错误写法原因分析 #

• 写法1 <DataTemplate x:DataType="m:SelectionItem"/>：泛型类必须指定具体类型参数，直接使用不带参数的泛型类名称，XAML无法识别具体类型，因此完全失效。
• 写法2 <DataTemplate x:DataType="m:SelectionItem1"/>：仅声明了开放构造的泛型类型（未绑定具体参数），XAML编辑器无法推断Item`的实际类型，所以无法提供绑定智能提示。
• 写法3 <DataTemplate x:DataType="m:SelectionItem(e:Message)"/>：该语法不符合XAML泛型类型的声明规范，解析器无法识别，因此抛出无效值错误。

额外注意事项 #

• 确保XAML文件头部已正确引入对应命名空间：

  xmlns:m="clr-namespace:你的SelectionItem类所在命名空间"
  xmlns:e="clr-namespace:你的Message类所在命名空间"
  

• 确认SelectionItem<T>的Item属性为公共可访问状态，且类已正确实现属性变更通知（你继承ObservableObject已满足该要求）。

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