为何部分BindableProperty无效？Username绑定属性无法识别问题

API 探路者

2026-5-14

问题根源：BindableProperty 命名与属性名不匹配

你遇到的这个绑定错误，核心原因是BindableProperty 的命名没有遵循和 CLR 属性对应的约定，导致绑定系统无法正确关联两者。

先看你的代码细节：

CLR 属性名是 Username（注意是小写的 n）
但你定义的 BindableProperty 是 UserNameProperty（大写的 N）

在 .NET 绑定体系（包括 WPF、Xamarin、MAUI 等）中，默认的核心约定是：BindableProperty 的名称必须是 [CLR属性名]Property——也就是说，CLR 属性 Username 对应的 BindableProperty 应该是 UsernameProperty，而不是 UserNameProperty。绑定系统会根据这个约定自动查找属性对应的 BindableProperty，大小写不一致就会导致匹配失败。

另外，你在 BindableProperty.Create 里用了 nameof(LiveView.Username)，虽然这个写法不会生成错误字符串，但更简洁规范的方式是直接用 nameof(Username)，避免硬编码类型名，减少维护风险。

修正后的代码

// CLR 属性
public string Username { get => (string)GetValue(UsernameProperty); set => SetValue(UsernameProperty, value); }

// 对应的 BindableProperty，严格遵循命名约定
public static readonly BindableProperty UsernameProperty = BindableProperty.Create(
    nameof(Username),
    typeof(string),
    typeof(LiveView),
    null);

为什么其他属性能正常工作？

你的 Title 和 UserImage 属性肯定严格遵循了这个命名约定：比如 Title 对应 TitleProperty，UserImage 对应 UserImageProperty，所以绑定系统能顺利找到对应的 BindableProperty；而 Username 因为大小写不一致打破了约定，才出现了识别失败的错误。