.NET MAUI中CollectionView选中项与同属性绑定控件异常问题

问题描述 #

我在.NET MAUI应用里把Label的Text和CollectionView的SelectedItem都双向绑定到ViewModel的同一个SelectedTime（DateTime?类型）属性。原本预期点击CollectionView里的项时，Label会显示对应格式化文本，同时选中项的颜色同步变化。但实际情况是：第一次点击项时只有Label文本更新，选中项的颜色得第二次点击才会变。我已经用复制属性加[NotifyPropertyChangedFor]的方式临时解决了，但想知道问题根源和正确的修复方法。

页面代码 #

<toolkit:Expander Margin="0,15">
    <toolkit:Expander.Header>
        <StackLayout Orientation="Horizontal">
            <Label FontSize="Medium" Text="{Binding SelectedTime, Mode=TwoWay, StringFormat='{0:hh:mm tt}'}" />
        </StackLayout>
    </toolkit:Expander.Header>
    <HorizontalStackLayout Padding="10">
        <CollectionView
            Margin="5,5,5,15"
            ItemSizingStrategy="MeasureAllItems"
            ItemsSource="{Binding Times, Mode=OneTime}"
            SelectedItem="{Binding SelectedTime, Mode=TwoWay}"
            SelectionMode="Single">
            <CollectionView.ItemsLayout>
                <GridItemsLayout Orientation="Vertical" Span="3" />
            </CollectionView.ItemsLayout>
            <CollectionView.ItemTemplate>
                <DataTemplate>
                    <ContentView Padding="5">
                        <Border StrokeShape="RoundRectangle 10" StrokeThickness="1">
                            <Label
                                Padding="10"
                                BackgroundColor="Transparent"
                                FontAttributes="Bold"
                                HorizontalTextAlignment="Center"
                                Text="{Binding ., StringFormat='{0:hh:mm tt}'}"
                                TextColor="Black" />
                        </Border>
                    </ContentView>
                </DataTemplate>
            </CollectionView.ItemTemplate>
        </CollectionView>
    </HorizontalStackLayout>
</toolkit:Expander>

ViewModel代码 #

[ObservableProperty]
[Required(ErrorMessage = "Please select the time of your appointment.")]
private DateTime? _selectedTime;

问题原因 #

核心问题出在Label的Text绑定设置了不必要的Mode=TwoWay：

• Label的Text是string类型，绑定的源是DateTime?，StringFormat仅负责把DateTime?格式化为字符串显示，但反向绑定时，无法将格式化后的字符串（比如"09:30 AM"）正确转换回DateTime?类型，会触发绑定转换失败。
• 这种异常会干扰绑定系统的正常流程：虽然CollectionView已经把选中项的值更新到ViewModel的SelectedTime，但控件自身的选中状态UI刷新被延迟或阻塞，必须第二次点击才能触发正确的状态同步。

正确修复方法 #

只需将Label的Text绑定模式改为OneWay（默认就是OneWay，可直接省略Mode参数）：

<Label FontSize="Medium" Text="{Binding SelectedTime, StringFormat='{0:hh:mm tt}'}" />

Label仅用于显示SelectedTime的格式化结果，完全不需要反向修改ViewModel的属性，移除多余的双向绑定后，绑定流程恢复正常，CollectionView的选中状态会和Label的文本更新同步触发。

临时方案的原理说明 #

你用复制属性加[NotifyPropertyChangedFor]的方式，本质是让ViewModel在SelectedTime变更时额外触发一次关联属性的变更通知，强制绑定系统重新同步CollectionView的选中状态，相当于绕过了双向绑定异常导致的阻塞，但这属于冗余的临时方案，不如直接修正Label的绑定模式简洁可靠。

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