MAUI中ContentView属性与ViewModel对象属性绑定错误排查

问题根源 #

你遇到的Error 127是MAUI编译时绑定检查的特性导致的：

• MAUI的编译时绑定会静态验证绑定路径上的属性是否匹配目标控件的属性要求。ProgressBar.Progress是可读写的依赖属性，编译器默认会检查绑定的属性是否具备public的setter（即便你实际只需要单向读取）。
• 你的ProgressionRatio属性setter是private，编译时静态检查无法通过，因此抛出错误。但运行时绑定依赖反射机制，只要getter是public就能正常读取值，再加上你手动调用了OnPropertyChanged(nameof(ProgressionRatio))通知属性变更，所以视图能正确更新。

而将ProgressionRatio移到ViewModel时，[ObservableProperty]自动生成了public的get/setter，满足编译时检查的要求，因此不会报错。

解决方案 #

推荐采用以下两种方式解决：

1. 显式指定绑定模式为OneWay #

告诉编译器该绑定仅需读取属性值，无需写入，这样就不会检查setter的访问性：

<tt:ProgressBar Progress="{Binding SessionProgression.ProgressionRatio, Mode=OneWay}" />

2. 调整属性setter访问性（不推荐，除非必要） #

如果不介意打破封装，可以将ProgressionRatio的setter改为internal或public，让编译时检查通过：

public double ProgressionRatio { get; internal set; }

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