C# CheckBox使用教程与注意事项

CheckBox仅表达选中/未选中状态，不执行即时操作；WinForms用Checked（bool），WPF/WinUI用IsChecked（bool?支持三态）；启用ThreeState后需手动处理CheckedChanged事件；批量读取应遍历容器子控件或绑定数据源；禁用以CheckBox直接触发副作用，应统一收口至提交动作。

CheckBox 不是用来“开关操作”的，它只表达状态；选中/未选中是它的核心语义，强行让它执行即时动作或模拟三态业务逻辑，八成会出 bug。

CheckBox 的 Checked 和 IsChecked 到底该用哪个？

取决于你用的是 WinForms 还是 WPF/UWP/WinUI：

• WinForms：用 Checked（bool? 类型不可用），读写都直接访问 checkBox1.Checked
• WPF / WinUI 3：必须用 IsChecked（bool? 类型），因为它支持三态：true、false、null（对应 Indeterminate）
• 别混用：在 WinForms 中写 checkBox1.IsChecked 会编译报错；在 WPF 中硬写 Checked 属性根本不存在

为什么 ThreeState = true 后点击没反应？

因为启用三态后，Click 事件不再自动切换状态——系统把控制权交给你了。默认点击行为被禁用，否则无法区分“用户点一下想设为 null”还是“点一下想设为 true”。

• 必须手动处理 CheckedChanged 事件，并在其中判断当前 IsChecked 值来决定下一步状态
• 常见错误：只监听 Click，结果点了没变化，还以为控件坏了
• 正确做法示例（WPF）：

  private void CheckBox_Checked(object sender, RoutedEventArgs e) {
      var cb = sender as CheckBox;
      if (cb.IsChecked == true) cb.IsChecked = false;
      else if (cb.IsChecked == false) cb.IsChecked = null;
      else cb.IsChecked = true;
  }

批量读取多个 CheckBox 状态时，别硬写 7 个 if (cbX.Checked)

这种写法不仅难维护，还容易漏掉新添加的复选框，更关键的是：它把 UI 控件和业务逻辑死绑在一起，后续加校验、改文案、换布局都会牵一发而动全身。

• 推荐用容器组织（如 Panel 或 StackPanel），然后遍历子控件：

  var selected = panel1.Controls.OfType()
      .Where(cb => cb.Checked)
      .Select(cb => cb.Text)
      .ToArray();

• WinForms 中注意：若 CheckBox 是直接拖到窗体上，需用 this.Controls；若放在 GroupBox 内，则用 groupBox1.Controls
• 更健壮的做法是绑定数据源（比如 BindingList<OptionItem>），让 CheckBox 的 DataContext 或 DataBindings 关联属性，而不是靠控件名硬编码

千万别用 CheckBox 实现“启用/禁用某功能”的即时开关

这是最常被踩的坑：用户点一下复选框，立刻调用 StartService() 或 SaveConfig()。问题在于——复选框本身不承诺“操作即刻生效”，它只是个状态快照。

• 用户可能勾选后又取消，中间触发了两次副作用，但实际什么都没发生
• 表单提交前要校验，你却在每次点击都保存，导致脏数据写入
• 正确姿势：把 CheckBox 当作“意愿标记”，所有副作用统一收口到提交动作里（比如按钮 Click 或表单 Validating 事件）
• 如果真需要即时响应（如预览开关），请换用 ToggleButton（WPF）或 Switch（WinUI），它们的设计契约就是“操作优先”

三态逻辑、事件绑定时机、状态与行为的边界——这些地方不细看文档很容易按直觉写错，而且 bug 表现得非常隐蔽：有时候能动，有时候不动，调试时断点进了又出不来。多花两分钟确认控件的设计意图，比花两小时追状态同步问题划算得多。