WPF：如何在模板化ListBox中实现单选CheckBox功能？

问题根源 #

你的无限循环是因为在Checked事件处理中手动设置CheckBox.IsChecked=true，这会再次触发Checked事件，形成闭环。同时把UI事件和ViewModel逻辑混在一起，违反了MVVM分离原则，也容易引发这类问题。

最优解决方案：将单选逻辑移至ViewModel层 #

完全去掉UI事件，通过属性绑定和事件订阅实现单选，彻底避免循环。

方案1：通过ViewModel监听Fighter选中状态变更 #

1. 修改Controller类

添加对每个Fighter的PropertyChanged事件订阅，处理单选逻辑，同时用标记位避免递归触发：

internal class Controller
{
    private ObservableCollection<Fighter> fighterList = new ObservableCollection<Fighter>();
    public ObservableCollection<Fighter> p_fighterList
    {
        get { return fighterList; }
        set { fighterList = value; }
    }

    // 标记是否正在处理选中状态变更，防止递归触发
    private bool _isUpdatingSelection;

    public Controller()
    {
        p_fighterList.Add(new Fighter("Scorpion"));
        p_fighterList.Add(new Fighter("Sub Zero"));
        p_fighterList.Add(new Fighter("Liu Kang"));

        // 给每个Fighter绑定属性变更事件
        foreach (var fighter in p_fighterList)
        {
            fighter.PropertyChanged += Fighter_PropertyChanged;
        }
    }

    private void Fighter_PropertyChanged(object? sender, PropertyChangedEventArgs e)
    {
        // 只处理p_selected属性的变化，且跳过正在更新的状态
        if (e.PropertyName != nameof(Fighter.p_selected) || _isUpdatingSelection)
            return;

        var selectedFighter = sender as Fighter;
        if (selectedFighter?.p_selected != true)
            return;

        // 进入更新状态，防止递归
        _isUpdatingSelection = true;

        // 取消其他所有项的选中状态
        foreach (var fighter in p_fighterList)
        {
            if (fighter != selectedFighter)
                fighter.p_selected = false;
        }

        // 更新完成，重置标记
        _isUpdatingSelection = false;
    }

    public void DeselectAll()
    {
        _isUpdatingSelection = true;
        foreach (Fighter fighter in p_fighterList)
        {
            fighter.p_selected = false;
        }
        _isUpdatingSelection = false;
    }
}

2. 修改XAML，移除Checked事件

只保留双向绑定即可：

<ListBox ItemsSource="{Binding Path=p_fighterList}">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <WrapPanel>
                <CheckBox IsChecked="{Binding Path=p_selected, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}" />
                <TextBlock Text="{Binding Path=p_name}" />
            </WrapPanel>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

3. 清理UI代码

删除MainWindow中的NewFighterSelected事件处理方法，逻辑已完全移至ViewModel层。

方案2：利用ListBox原生单选特性（更简洁） #

如果希望CheckBox状态与ListBox选中项联动，可以直接复用ListBox的SelectedItem：

1. 修改Controller实现INotifyPropertyChanged

添加SelectedFighter属性处理单选：

internal class Controller : INotifyPropertyChanged
{
    public event PropertyChangedEventHandler? PropertyChanged;

    private ObservableCollection<Fighter> fighterList = new ObservableCollection<Fighter>();
    public ObservableCollection<Fighter> p_fighterList
    {
        get { return fighterList; }
        set { fighterList = value; RaisePropertyChanged(nameof(p_fighterList)); }
    }

    private Fighter? _selectedFighter;
    public Fighter? SelectedFighter
    {
        get { return _selectedFighter; }
        set
        {
            if (_selectedFighter != value)
            {
                // 取消之前选中项的状态
                _selectedFighter?.p_selected = false;
                _selectedFighter = value;
                // 设置新选中项的状态
                _selectedFighter?.p_selected = true;
                RaisePropertyChanged(nameof(SelectedFighter));
            }
        }
    }

    public Controller()
    {
        p_fighterList.Add(new Fighter("Scorpion"));
        p_fighterList.Add(new Fighter("Sub Zero"));
        p_fighterList.Add(new Fighter("Liu Kang"));
    }

    public void RaisePropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

2. 修改XAML绑定ListBox选中项

<ListBox ItemsSource="{Binding Path=p_fighterList}" 
         SelectionMode="Single"
         SelectedItem="{Binding SelectedFighter}">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <WrapPanel>
                <CheckBox IsChecked="{Binding Path=p_selected, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}" />
                <TextBlock Text="{Binding Path=p_name}" />
            </WrapPanel>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

之前尝试失败的原因 #

• 尝试1：手动设置IsChecked=true会再次触发Checked事件，形成循环。
• 尝试2：直接修改p_selected会触发PropertyChanged更新UI，若保留Checked事件仍会触发循环。
• 尝试3：OneTime绑定切断了UI与ViewModel的联动，导致ViewModel更新时UI无法同步。

关键注意点：始终通过ViewModel层处理业务逻辑，避免在UI代码中直接操作控件状态；用标记位避免递归触发属性变更事件。

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