.NET MAUI绑定BindableProperty报错‘值与属性类型不匹配’

针对你遇到的XFC0009错误，核心问题基本出在BindableProperty的定义不符合.NET MAUI绑定系统的规范，以下是具体排查和修正步骤：

1. 严格遵循BindableProperty定义规范 #

自定义视图的可绑定属性必须严格按照命名和实现规则编写，这是绑定系统识别属性的关键：

正确示例： #

public partial class SettingView : ContentView // 必须继承自BindableObject子类，如ContentView/View
{
    // 静态字段命名必须是「属性名+Property」后缀
    public static readonly BindableProperty BoundObjectProperty =
        BindableProperty.Create(
            nameof(BoundObject), // 必须与属性名完全一致，用nameof避免硬编码错误
            typeof(string),      // 属性的类型，必须和下方属性的类型匹配
            typeof(SettingView), // 自定义视图的类型
            defaultValue: string.Empty); // 可选：设置默认值

    // 属性的get/set必须调用GetValue/SetValue，不能用私有变量存储
    public string BoundObject
    {
        get => (string)GetValue(BoundObjectProperty);
        set => SetValue(BoundObjectProperty, value);
    }

    public SettingView()
    {
        InitializeComponent();
    }
}

常见错误点： #

• 静态字段命名错误：比如写成BoundObjProperty，但属性名是BoundObject，导致绑定系统无法匹配
• 属性的get/set用私有变量实现：没有调用GetValue/SetValue，绑定系统无法识别这是可绑定属性
• 注册参数错误：Create方法的第一个参数（属性名）拼写错误，或类型参数（typeof(string)/typeof(SettingView)）写错

2. 排查自定义视图的基类 #

确保你的SettingView继承自BindableObject的子类（如ContentView、View等），只有继承这类基类的控件才能拥有DataContext和可绑定属性，原生Label能正常绑定就是因为它本身是BindableObject子类。

3. 处理Intellisense缓存问题 #

编辑器提示“未找到Binding的DataContext”大概率是VS缓存问题，可按以下步骤解决：

• 清理项目：右键项目→选择「清理」
• 删除bin/obj文件夹
• 重启Visual Studio

关于Object类型绑定的误区 #

当你把BindableProperty改成Object类型时能编译，但拿到的是Binding对象而非实际值，这是因为：
绑定系统只有识别到属性对应正确的BindableProperty时，才会解析{Binding ...}表达式并赋值最终数据；如果属性定义不规范，XAML会把Binding对象当作普通值直接赋值给属性，而非执行绑定逻辑。

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