Xamarin.Forms中SelectItem绑定报错：未找到属性或类型不匹配排查

核心排查方向 #

XFC0009错误本质是控件的属性未被识别或绑定值与属性类型不匹配，以下是针对性解决步骤：

1. 检查BindableProperty的命名与注册正确性 #

自定义控件的绑定属性必须严格遵循「属性名+Property」的命名规则，且注册时要与属性完全对应：

• 错误示例：

  // 属性名是SelectItem，但BindableProperty注册成了SelectedItemProperty
  public static readonly BindableProperty SelectedItemProperty = 
      BindableProperty.Create(nameof(SelectItem), typeof(string), typeof(CtrlPickerButton));
  

• 正确示例：

  public static readonly BindableProperty SelectItemProperty = 
      BindableProperty.Create(nameof(SelectItem), typeof(object), typeof(CtrlPickerButton));
  
  public object SelectItem
  {
      get => GetValue(SelectItemProperty);
      set => SetValue(SelectItemProperty, value);
  }
  

  注意：属性的get/set必须通过GetValue/SetValue关联绑定属性，不能用普通自动属性。

2. 确认绑定值与属性类型完全匹配 #

如果控件的SelectItem定义为string类型，但ViewModel中绑定的是int或自定义实体类（比如User），就会触发类型不匹配：

• 场景1：控件属性类型是string，ViewModel绑定的是int类型
  解决：要么修改控件的SelectItem类型为int，要么在绑定中添加Converter转换类型：

  <local:CtrlPickerButton SelectItem="{Binding SelectedId, Converter={StaticResource IntToStringConverter}}" />
  

• 场景2：控件属性类型是object，但绑定的集合项类型与选中项类型不一致
  解决：确保ViewModel中选中项的类型和集合中元素的类型一致，比如集合是ObservableCollection<User>，则选中项必须是User类型。

3. 检查XAML的命名空间引用 #

确认XAML中是否正确引用了自定义控件所在的命名空间，拼写错误会导致控件被误识别，进而找不到属性：

• 正确的命名空间引用示例：

  xmlns:local="clr-namespace:YourAppName.Controls"
  

  注意：clr-namespace后的命名空间要和CtrlPickerButton所在的C#命名空间完全一致。

4. 排查XAML中的属性拼写 #

检查XAML中SelectItem的拼写是否和C#控件中的属性名完全一致，大小写敏感（比如写成Selectitem或SelectedItem都会出错）。

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