为页面XAML添加x:DataType导致ListView DataTemplate属性报错

问题场景 #

通过代码后台设置ViewModel实现依赖注入，希望保留XAML的IntelliSense提示功能。给ContentPage添加x:DataType="viewModels:HomeViewModel"后，出现Number属性未找到的编译错误，删除该属性则恢复正常。

原错误代码 #

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MyApp.Pages.HomePage"
             xmlns:viewModels="clr-namespace:MyApp.ViewModels"
             x:DataType="viewModels:HomeViewModel"
             Title=""
             NavigationPage.HasNavigationBar="False">

      <Frame>
        <Grid>
          <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
          </Grid.RowDefinitions>
          <Label Grid.Row="0"></Label>
          <ListView ItemsSource="{Binding TotalData}" Grid.Row="1">
            <ListView.ItemTemplate>
              <DataTemplate>
                <ViewCell>
                  <Grid Padding="5">
                    <Label Text="{Binding Number}" Margin="0,0,10,0"/>
                  </Grid>
                </ViewCell>
              </DataTemplate>
            </ListView.ItemTemplate>
          </ListView>
        </Grid>
      </Frame>
</ContentPage>

错误原因 #

给ContentPage设置x:DataType后，页面内所有未明确指定数据类型的绑定元素会默认继承该上下文（HomeViewModel）。但Number属性属于TotalData集合中的元素模型（如DataModel），并非HomeViewModel的属性，因此编译器无法定位该属性，触发错误。

修复后的代码 #

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MyApp.Pages.HomePage"
             xmlns:viewModels="clr-namespace:MyApp.ViewModels"
             xmlns:models="clr-namespace:MyApp.Models"
             x:DataType="viewModels:HomeViewModel"
             Title=""
             NavigationPage.HasNavigationBar="False">

      <Frame>
        <Grid>
          <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
          </Grid.RowDefinitions>
          <Label Grid.Row="0"></Label>
          <ListView ItemsSource="{Binding TotalData}" Grid.Row="1">
            <ListView.ItemTemplate>
              <DataTemplate x:DataType="models:DataModel">
                <ViewCell>
                  <Grid Padding="5">
                    <Label Text="{Binding Number}" Margin="0,0,10,0"/>
                  </Grid>
                </ViewCell>
              </DataTemplate>
            </ListView.ItemTemplate>
          </ListView>
        </Grid>
      </Frame>
</ContentPage>

修复要点 #

• 添加Models命名空间引用：xmlns:models="clr-namespace:MyApp.Models"，用于指定集合元素的模型类型
• 给DataTemplate设置x:DataType="models:DataModel"，明确子元素的绑定上下文为集合中的数据模型，编译器即可正确识别Number属性

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