MAUI中CollectionView内自定义Switch控件绑定报错求助

核心错误：BindableProperty命名不规范 #

Xamarin.Forms要求自定义可绑定属性遵循属性名+Property的命名规则，你的代码中属性名为IsToggledValue，但对应的BindableProperty却命名为IsToggledProperty，这导致XAML绑定系统无法找到匹配的可绑定属性，直接触发XFC0009错误。

其他问题点 #

1. PropertyChanged事件循环调用：原事件中重新给IsToggledValue赋值，会触发属性变更的循环调用，造成不必要的性能消耗甚至死循环。
2. 冗余的INotifyProperty继承：ContentView已通过继承链实现了INotifyPropertyChanged接口，无需手动声明。
3. Tap命令UI逻辑冗余：手动修改UI控件状态后再更新属性，可简化为直接修改属性值，通过PropertyChanged事件统一更新UI。
4. 绑定模式未明确：CollectionView中需要双向绑定确保控件状态与数据源同步，默认模式可能不是双向。

修正后的CustomSwitchView代码 #

public partial class CustomSwitchView : ContentView
{
    // 修正BindableProperty命名，遵循属性名+Property的规则，并默认设置双向绑定
    public static readonly BindableProperty IsToggledValueProperty = BindableProperty.Create(
        nameof(IsToggledValue),
        typeof(bool),
        typeof(CustomSwitchView),
        defaultValue: false,
        defaultBindingMode: BindingMode.TwoWay,
        propertyChanged: IsToggledValuePropertyChanged
    );

    public bool IsToggledValue
    {
        get => (bool)GetValue(IsToggledValueProperty);
        set => SetValue(IsToggledValueProperty, value);
    }

    private void SetSwitchState()
    {
        if (IsToggledValue)
        {
            Switch_Circle.SetValue(Grid.ColumnProperty, 1);
            Switch_Body.BackgroundColor = Color.FromRgb(122, 146, 105);
        }
        else
        {
            Switch_Circle.SetValue(Grid.ColumnProperty, 0);
            Switch_Body.BackgroundColor = Color.FromRgb(255, 255, 255);
        }
    }

    // 修正PropertyChanged事件，仅更新UI而非重新赋值属性
    private static void IsToggledValuePropertyChanged(BindableObject bindable, object oldValue, object newValue)
    {
        var switchView = bindable as CustomSwitchView;
        switchView?.SetSwitchState();
    }

    private void this_Loaded(object sender, EventArgs e)
    {
        SetSwitchState();
    }

    // 简化Tap命令，仅修改属性值，UI更新交给PropertyChanged事件处理
    [RelayCommand]
    void Tap()
    {
        IsToggledValue = !IsToggledValue;
    }

    public CustomSwitchView()
    {
        InitializeComponent();
    }
}

XAML绑定修正 #

在CollectionView的DataTemplate中，明确设置双向绑定模式：

<views:CustomSwitchView x:Name="SwitchView_Allergenics" Margin="0,0,20,0" Grid.Column="1" HorizontalOptions="End"
                       IsToggledValue="{Binding IsSelected, Mode=TwoWay}"/>

额外说明 #

• 确保你的数据源模型（即CollectionView绑定的项）中的IsSelected属性实现了INotifyPropertyChanged，这样数据源变更时才能同步更新控件状态。
• 修正后无论在CollectionView内还是外，绑定都能正常工作，因为可绑定属性的命名符合框架规范，且双向绑定模式确保了数据同步。

内容的提问来源于stack exchange，提问作者Gustavo José