MAUI自定义ContentView绑定列表项报错，如何正确传递数据？

错误原因 #

你遇到的'GardenerMaster.Views.ListviewItemView' cannot be converted to type 'GardenerMaster.Models.Creature'错误，是因为错误地将x:DataType="m:Creature"直接应用在了自定义控件ListviewItemView标签上。这会让XAML编译器误认为该控件的类型是Creature，但实际控件本身是ContentView派生的ListviewItemView，从而引发类型转换冲突。

正确解决方案 #

将x:DataType="m:Creature"转移到DataTemplate上，明确整个列表项模板的数据上下文是Creature实例，然后直接通过{Binding .}将当前项传递给自定义控件的Creature绑定属性即可。

修改后的ListView XAML代码

<ListView ItemsSource="{Binding Creature.FriendlyEnvironment}"
          x:DataType="vm:PlantDetailsViewModel">
    <ListView.ItemTemplate>
        <!-- 将x:DataType设置在DataTemplate上，明确模板上下文为Creature -->
        <DataTemplate x:DataType="m:Creature">
            <ViewCell>
                <!-- 移除控件上的x:DataType，直接绑定当前项到Creature属性 -->
                <v:ListviewItemView Creature="{Binding .}" />
            </ViewCell>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

自定义控件的代码无需修改

你的ListviewItemView后台代码和XAML代码都是正确的：

• 后台代码中CreatureProperty绑定属性的定义符合规范
• 控件XAML中x:DataType="v:ListviewItemView"正确指向自身，{Binding Creature.Name}能正确访问绑定的Creature实例的Name属性

额外验证点 #

确保父页面的XAML中已正确导入所需命名空间：

xmlns:m="clr-namespace:GardenerMaster.Models"
xmlns:v="clr-namespace:GardenerMaster.Views"
xmlns:vm="clr-namespace:GardenerMaster.ViewModels"

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