WinForms TextBox AutoCompleteMode 不生效的主因是控件未完成句柄创建或状态异常；须在 HandleCreated 后配置，用 CustomSource 而非 ListItems，并确保 UI 线程更新数据源。
WinForms 中 TextBox 的 AutoCompleteMode 不生效？
多数人卡在这一步：设了 autocompletemode 和 autocompletesource，但输入时完全没提示。根本原因不是代码写错，而是漏掉了关键前提——textbox 必须处于可编辑、已聚焦、且未被禁用状态；更隐蔽的是，如果窗体刚加载完就立刻设置自动补全，而此时 textbox 尚未完成句柄创建（ishandlecreated == false），补全功能会静默失效。
实操建议：
- 确保在
Form.Load事件之后、或TextBox.HandleCreated触发后才配置补全逻辑 - 用
AutoCompleteMode = AutoCompleteMode.SuggestAppend（最常用），避免只用Suggest导致用户无法直接输入新内容 -
AutoCompleteSource推荐设为AutoCompleteSource.CustomSource，再手动赋值AutoCompleteCustomSource，比用ListItems更可控 - 若数据源是动态更新的（比如从 API 加载），别反复 new
AutoCompleteStringCollection，复用并调用Clear()+AddRange()即可
C# 自定义 AutoCompleteStringCollection 的线程安全陷阱
很多人把数据库查出的字符串列表直接塞进 AutoCompleteCustomSource，结果在后台线程更新数据时抛出 InvalidOperationException: “列表正在被另一个线程修改”。这不是 .NET Bug，而是 WinForms 控件内部对 AutoCompleteStringCollection 的访问未加锁，且该集合本身不支持并发读写。
实操建议：
- 所有对
AutoCompleteCustomSource的修改（Add、Clear、AddRange）必须在 UI 线程执行，用Invoke或BeginInvoke包裹 - 不要在
TextChanged里实时查库+更新补全源——响应延迟高，还容易触发重复请求；改用防抖（debounce）逻辑，例如延迟 300ms 再查 - 若补全项超 500 条，考虑按前缀预筛（如
source.Where(s => s.StartsWith(input))），否则下拉列表渲染卡顿明显
WPF 或 Blazor 中没有 TextBox.AutoCompleteMode 怎么办？
C# 不等于 WinForms。WPF 的 TextBox 原生不支持自动补全，Blazor 的 <input> 更依赖前端逻辑。硬套 WinForms 思路只会白忙活。
实操建议：
- WPF 推荐用第三方控件如
Syncfusion SfTextBoxExt或MahApps.Metro TextBox，它们内置AutoCompleteBehavior，支持绑定IEnumerable<string></string>和自定义筛选器 - Blazor 中，用
@bind+@oninput拦截输入，结合Fetch请求后端匹配项，再用<div class="autocomplete-list"> 手动渲染下拉；注意控制显示/隐藏逻辑，避免失焦时列表残留<li>别试图用 JavaScript 互操作给 Blazor <code>input注入原生list属性——Chrome 虽支持<datalist></datalist>，但无法动态更新选项，且 Firefox 行为不一致 - 彻底放弃
ListItems，改用CustomSource，一行就能搞定：textBox1.AutoCompleteCustomSource.AddRange(myStringArray) - 如果非要绑定控件数据源（比如 ComboBox 已有数据），直接取
comboBox1.Items.Cast<string>().ToArray()</string>再喂给CustomSource，别指望 WinForms 自动桥接 - 注意大小写敏感：默认匹配是区分大小写的，如需忽略，得自己实现
AutoCompleteStringCollection的子类重写匹配逻辑（极少需要，先确认是否真有必要）
AutoCompleteSource.ListItems 为什么总返回空？
选了 AutoCompleteSource.ListItems，但下拉始终空白，检查数据源发现明明有值。问题出在 WinForms 的设计限制：ListItems 只认绑定到 ComboBox 或 ListBox 的 DataSource，且要求该数据源是 IList 或 IBindingList，普通数组或 List<string></string> 不行——它不会自动转换，也不会报错，只是静默忽略。
实操建议：
补全功能看着简单，实际最麻烦的是状态同步：输入框焦点、数据加载中、网络失败、用户快速连打、退格删到空……这些边界情况一叠加，很容易漏掉某次 Clear() 或忘了重置下拉可见性。与其堆逻辑，不如从一开始就把补全源的更新包装成一个带 loading 状态的独立方法，其他地方只管调用。
