.NET 9 MAUI自定义ContentView绑定BindableProperty消除XC0025警告

XC0025警告的核心原因是XAML编译器无法自动推断绑定的数据源类型。对于无ViewModel的自定义ContentView，数据源就是组件自身，只需通过以下两种方式即可消除警告：

方法一：指定x:DataType为组件自身类型 #

在ContentView的XAML根元素上添加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:local="clr-namespace:YourAppNamespace.Components"
             x:Class="YourAppNamespace.Components.WordCheck"
             x:DataType="local:WordCheck"> <!-- 指定组件自身作为数据类型 -->
    <StackLayout>
        <!-- 直接绑定Answer属性，编译器可通过x:DataType推断类型 -->
        <Label Text="{Binding Answer}" />
    </StackLayout>
</ContentView>

后台代码（BindableProperty定义参考） #

namespace YourAppNamespace.Components;

public partial class WordCheck : ContentView
{
    public static readonly BindableProperty AnswerProperty =
        BindableProperty.Create(nameof(Answer), typeof(string), typeof(WordCheck), string.Empty);

    public string Answer
    {
        get => (string)GetValue(AnswerProperty);
        set => SetValue(AnswerProperty, value);
    }

    public WordCheck()
    {
        InitializeComponent();
    }
}

方法二：显式指定绑定源为Self #

如果不想设置x:DataType，也可以在绑定中通过RelativeSource明确指定数据源为组件自身，同样能让编译器识别绑定类型：

<Entry Text="{Binding Source={RelativeSource Self}, Path=Answer}" />

注意事项 #

不要随意设置BindingContext = this，这会导致组件被嵌入页面时，继承页面的BindingContext而破坏自身绑定逻辑。上述两种方法都无需修改BindingContext，是更安全的实现方式。

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