WPF中CollectionView过滤后CheckBox选中状态丢失的解决方法

问题复现 #

场景：WPF项目中ItemsControl的列表项为CheckBox，勾选后执行集合视图过滤，已勾选状态丢失。
复现代码：

1. 数据源定义

public ObservableCollection<string> Names { get; set; } = new() { "A", "B", "C", "D", "E", "F" };

2. XAML布局

<Grid>
    <Grid Width="150" Height="30">
        <TextBox x:Name="TextBoxSearch" PreviewKeyUp="UIElement_OnPreviewKeyUp"/>
        <Path Style="{StaticResource SearchIconStyle}" HorizontalAlignment="Right"/>
    </Grid>
    <ItemsControl x:Name="ItemsControlNames" ItemsSource="{Binding Source={StaticResource NamesKey}}">
        <ItemsControl.ItemTemplate>
            <DataTemplate>
                <StackPanel Orientation="Horizontal">
                    <CheckBox Content="{Binding}" Height="33" Padding="5"/>
                </StackPanel>
            </DataTemplate>
        </ItemsControl.ItemTemplate>
    </ItemsControl>
</Grid>

3. 过滤逻辑

private void UIElement_OnPreviewKeyUp(object sender, KeyEventArgs e)
{
    if (ItemsControlNames?.ItemsSource is ICollectionView cView)
    {
        cView.Filter = FilterByName;
    }
}

private bool FilterByName(object item)
{
    if (item is string s)
    {
        return s.IndexOf(TextBoxSearch.Text, StringComparison.OrdinalIgnoreCase) >= 0 || string.IsNullOrWhiteSpace(TextBoxSearch.Text);
    }
    return true;
}

复现效果：

问题根因 #

选中状态丢失的核心原因有两个：

• 绑定的数据源是裸字符串，没有存储选中状态的属性，CheckBox的IsChecked没有做任何双向绑定，选中状态仅临时存在于生成的CheckBox控件实例上
• 触发过滤时，ItemsControl会回收、重建或复用列表项容器，临时存在UI控件上的未持久化状态会被直接清空

解决方案 #

方案1：改造数据模型+双向绑定（推荐，符合WPF设计规范） #

把选中状态持久化到数据层，和UI生命周期解耦，从根源解决状态丢失问题，兼容过滤、排序、虚拟化滚动等所有场景：

1. 定义带选中状态的数据模型，实现属性变更通知

public class SelectableNameItem : INotifyPropertyChanged
{
    private bool _isSelected;
    /// <summary>
    /// 显示的名称
    /// </summary>
    public string DisplayName { get; set; }
    /// <summary>
    /// 选中状态
    /// </summary>
    public bool IsSelected
    {
        get => _isSelected;
        set
        {
            if (_isSelected == value) return;
            _isSelected = value;
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(IsSelected)));
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;
}

2. 替换原有字符串集合为包装模型集合

public ObservableCollection<SelectableNameItem> Names { get; set; } = new()
{
    new() { DisplayName = "A" },
    new() { DisplayName = "B" },
    new() { DisplayName = "C" },
    new() { DisplayName = "D" },
    new() { DisplayName = "E" },
    new() { DisplayName = "F" }
};

3. 修改XAML中CheckBox的绑定关系，将IsChecked双向绑定到模型的选中属性

<CheckBox 
    Content="{Binding DisplayName}" 
    IsChecked="{Binding IsSelected, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}"
    Height="33" 
    Padding="5"/>

改造后所有选中状态存储在数据模型中，无论UI容器如何重建复用，状态都不会丢失，同时后续要获取所有选中项也可以直接遍历集合取IsSelected=true的项，逻辑更清晰。

方案2：关闭列表虚拟化（仅适合小数据量场景） #

如果列表项数量极少（一般不超过100项），不想改造数据结构，可以直接关闭ItemsControl的容器虚拟化，让控件一次性生成所有列表项容器，不会在过滤时重建容器，状态自然保留：

<ItemsControl 
    x:Name="ItemsControlNames" 
    ItemsSource="{Binding Source={StaticResource NamesKey}}"
    VirtualizingStackPanel.IsVirtualizing="False">
    <!-- 其余原有代码保持不变 -->
</ItemsControl>

注意：该方案会大幅增加大列表的内存占用和加载耗时，数据量超过100项时不建议使用。

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