如何保存WinForm中CheckedListBox的勾选状态避免重复勾选

以下方案适配你已有的Properties.Settings.Default配置存储逻辑，分两种场景实现：

方案1：选项固定的CheckedListBox（最常用场景） #

步骤1：新增配置项 #

打开项目属性→「设置」页，为每个CheckedListBox新增用户级、类型为string的配置项，例如控件名是checkedListBox1，对应配置名设为CheckedListBox1State，默认值留空即可。

步骤2：编写状态读写辅助方法 #

// 读取CheckedListBox的勾选状态，拼接为字符串
private string GetCheckedListState(CheckedListBox clb)
{
    List<string> stateList = new List<string>();
    for (int i = 0; i < clb.Items.Count; i++)
    {
        stateList.Add(clb.GetItemChecked(i) ? "1" : "0");
    }
    return string.Join(",", stateList);
}

// 从字符串恢复CheckedListBox的勾选状态
private void SetCheckedListState(CheckedListBox clb, string stateStr)
{
    if (string.IsNullOrWhiteSpace(stateStr)) return;
    string[] stateArray = stateStr.Split(',');
    // 兼容存储的状态长度和当前控件项数量不一致的异常情况
    int matchCount = Math.Min(stateArray.Length, clb.Items.Count);
    for (int i = 0; i < matchCount; i++)
    {
        clb.SetItemChecked(i, stateArray[i] == "1");
    }
}

步骤3：整合到现有窗体生命周期逻辑 #

修改你现有的初始化和关闭逻辑，新增状态读写的代码：

private void InitializeSecondForm()
{
    this.Height = Properties.Settings.Default.SecondFormHeight;
    this.Width = Properties.Settings.Default.SecondFormWidth;
    this.Location = Properties.Settings.Default.SecondFormLocation;

    // 新增：加载所有CheckedListBox的勾选状态
    SetCheckedListState(checkedListBox1, Properties.Settings.Default.CheckedListBox1State);
    SetCheckedListState(checkedListBox2, Properties.Settings.Default.CheckedListBox2State);
    // 有更多控件继续按上面格式添加即可

    this.FormClosing += SecondFormClosingEventHandler;
    this.StartPosition = FormStartPosition.Manual;
}

private void SecondFormClosingEventHandler(object sender, FormClosingEventArgs e)
{
    Properties.Settings.Default.SecondFormHeight = this.Height;
    Properties.Settings.Default.SecondFormWidth = this.Width;
    Properties.Settings.Default.SecondFormLocation = this.Location;

    // 新增：保存所有CheckedListBox的勾选状态
    Properties.Settings.Default.CheckedListBox1State = GetCheckedListState(checkedListBox1);
    Properties.Settings.Default.CheckedListBox2State = GetCheckedListState(checkedListBox2);
    // 有更多控件继续按上面格式添加即可

    Properties.Settings.Default.Save();
}

方案2：选项动态生成的CheckedListBox #

如果你的CheckedListBox选项是运行时从接口/配置加载的，索引对应方式不可靠，可以选择存储选项文本和勾选状态的键值对：

1. 新增string类型的用户配置项存储序列化后的键值对
2. 保存时遍历CheckedListBox所有项，生成Dictionary<string, bool>结构，序列化为JSON字符串存入配置
3. 加载时反序列化JSON为字典，遍历控件的每个选项，匹配文本后设置对应勾选状态即可

注意：如果选项存在重复文本，可绑定数据源后用ValueMember对应的唯一值作为键存储，避免匹配错误。

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