.NET9 MAUI：如何正确设置DataType与BindingContext消除编译警告

问题背景 #

我在.NET9 MAUI中开启了CompiledBindings，正在处理所有编译警告。后台代码定义了一个带Count绑定属性的CountRound视图：

public partial class CountRound : ContentView
{
    public static readonly BindableProperty CountProperty =
        BindableProperty.Create("Count", typeof(int), typeof(CountRound), 0); 
    public int Count
    {
        get => (int)GetValue(CountProperty);
        set => SetValue(CountProperty, value);
    }
    public CountRound()
    {
        InitializeComponent();
    }
}

在.NET8中，我通过BindingContext="{Binding Source={RelativeSource Self}}"让ContentView绑定自身，Label的Text可以正确绑定Count，Border的Stroke也能识别静态资源的Color类型：

<?xml version="1.0" encoding="utf-8" ?>
<ContentView xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:models="clr-namespace:MyApp.Models"
             x:Class="MyApp.ContentViews.CountRound"
             BindingContext="{Binding Source={RelativeSource Self}}">
    <Border x:Name="CountBorder"
        StrokeShape="Ellipse"
        StrokeThickness="2"
        Stroke="{Binding Source={x:Static models:SiteConfiguration.RoundBorderColor}}"
        BackgroundColor="White"
        Opacity=".85"
        HeightRequest="24">
        <Label 
            Text="{Binding Count}"
            FontSize="12"
            TextColor="Black"
            HorizontalOptions="Center"
            VerticalOptions="Center"
            HorizontalTextAlignment="Center"
            VerticalTextAlignment="Center"
            Padding="0"/>
    </Border>
</ContentView>

但升级到.NET9后，出现两个编译警告：

1. BindingContext需要设置DataType
2. Border的Stroke绑定需要设置DataType

我尝试在ContentView和Stroke绑定上添加x:DataType，解决了Stroke的警告，但BindingContext的警告依然存在；如果把DataType移到BindingContext的Binding内部，虽然警告消除，但Label的Count属性无法被识别，编译器提示上下文是BindingExtension类型。

问题解析 #

1. 为什么BindingContext会被解析为BindingExtension？ #

当你把x:DataType写在BindingContext="{Binding ..., x:DataType=...}"内部时，编译绑定会把这个Binding对象本身（即BindingExtension类型）当作当前的数据上下文，而不是你期望的CountRound实例。BindingExtension没有Count属性，所以Label的绑定会失效。

2. 为什么.NET9要求设置DataType？ #

.NET9对编译绑定的类型检查更严格，当绑定源不是常规ViewModel（比如RelativeSource Self、静态资源这类非标准数据源）时，编译器无法自动推断源的类型，必须显式指定x:DataType来启用编译时类型验证，提前发现潜在的绑定错误。

正确解决方案 #

方案1：保留显式BindingContext设置 #

1. 在ContentView根节点设置全局x:DataType为自身类型，为整个视图的绑定提供默认上下文；
2. 为Stroke的静态资源绑定单独指定x:DataType，注意要写在Binding标记内部；
3. 不要在BindingContext的Binding中添加x:DataType。

最终XAML代码：

<?xml version="1.0" encoding="utf-8" ?>
<ContentView xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:models="clr-namespace:JMoApp.Models"
             xmlns:contentViews="clr-namespace:JMoApp.ContentViews"
             x:Class="JMoApp.ContentViews.CountRound"
             x:DataType="contentViews:CountRound"
             BindingContext="{Binding Source={RelativeSource Self}}">
    <Border x:Name="CountBorder"
            StrokeShape="Ellipse"
            StrokeThickness="2"
            Stroke="{Binding Source={x:Static models:SiteConfiguration.RoundBorderColor}, x:DataType=Color}"
            BackgroundColor="White"
            Opacity=".85"
            HeightRequest="24">
        <Label 
            Text="{Binding Count}"
            FontSize="12"
            TextColor="Black"
            HorizontalOptions="Center"
            VerticalOptions="Center"
            HorizontalTextAlignment="Center"
            VerticalTextAlignment="Center"
            Padding="0"  />
    </Border>
</ContentView>

方案2：移除显式BindingContext（更简洁） #

在编译绑定模式下，只要设置了x:DataType="contentViews:CountRound"，内部控件绑定自身属性时，编译器会自动推断上下文为当前ContentView实例，无需显式设置BindingContext，这样可以彻底避免BindingContext的警告：

<?xml version="1.0" encoding="utf-8" ?>
<ContentView xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:models="clr-namespace:JMoApp.Models"
             xmlns:contentViews="clr-namespace:JMoApp.ContentViews"
             x:Class="JMoApp.ContentViews.CountRound"
             x:DataType="contentViews:CountRound">
    <Border x:Name="CountBorder"
            StrokeShape="Ellipse"
            StrokeThickness="2"
            Stroke="{Binding Source={x:Static models:SiteConfiguration.RoundBorderColor}, x:DataType=Color}"
            BackgroundColor="White"
            Opacity=".85"
            HeightRequest="24">
        <Label 
            Text="{Binding Count}"
            FontSize="12"
            TextColor="Black"
            HorizontalOptions="Center"
            VerticalOptions="Center"
            HorizontalTextAlignment="Center"
            VerticalTextAlignment="Center"
            Padding="0"  />
    </Border>
</ContentView>

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