【Winform】实现“下拉自动补全”通常指的是 ComboBox / TextBox 在输入时自动提示或补全匹配项

在 WinForms 中，实现"下拉自动补全"通常指的是 ComboBox / TextBox 在输入时自动提示或补全匹配项 。下面按常见实现方式，从最简单到可定制进行说明，并给出示例代码。

一、使用 ComboBox 内置自动补全（最推荐）

1. 基本属性配置

WinForms 的 ComboBox 自带自动补全功能，只需设置三个属性即可：

csharp 复制代码

comboBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend;
comboBox1.AutoCompleteSource = AutoCompleteSource.ListItems;

2. 填充数据

csharp 复制代码

comboBox1.Items.AddRange(new string[]
{
    "Apple",
    "Banana",
    "Blueberry",
    "Cherry",
    "Grape",
    "Orange"
});

3. 常用模式说明

AutoCompleteMode	行为说明
None	不启用
Suggest	下拉提示
Append	自动补全剩余文本
SuggestAppend	提示 + 补全（最常用）

二、绑定数据源的自动补全（DataSource）

适用于数据库或集合数据。

csharp 复制代码

List<string> data = new List<string>
{
    "Beijing",
    "Shanghai",
    "Shenzhen",
    "Guangzhou"
};

comboBox1.DataSource = data;
comboBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend;
comboBox1.AutoCompleteSource = AutoCompleteSource.ListItems;

如果是对象集合：

csharp 复制代码

comboBox1.DataSource = cityList;
comboBox1.DisplayMember = "CityName";
comboBox1.ValueMember = "CityId";

三、TextBox + AutoCompleteCustomSource

如果你不需要下拉框，只需要输入补全：

csharp 复制代码

AutoCompleteStringCollection source = new AutoCompleteStringCollection();
source.AddRange(new string[] { "C#", "C++", "Java", "Python" });

textBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend;
textBox1.AutoCompleteSource = AutoCompleteSource.CustomSource;
textBox1.AutoCompleteCustomSource = source;

四、自定义模糊匹配（进阶，支持 contains）

默认的自动补全是 前缀匹配 。如果你需要"包含匹配"（如输入 an 能匹配 Banana），需要手动处理。

示例：TextUpdate 动态过滤

csharp 复制代码

private List<string> allItems = new List<string>
{
    "Apple",
    "Banana",
    "Orange",
    "Pineapple"
};

private void comboBox1_TextUpdate(object sender, EventArgs e)
{
    string text = comboBox1.Text;

    var filtered = allItems
        .Where(x => x.IndexOf(text, StringComparison.OrdinalIgnoreCase) >= 0)
        .ToList();

    comboBox1.DataSource = filtered;
    comboBox1.DroppedDown = true;
    comboBox1.SelectionStart = comboBox1.Text.Length;
}

⚠ 注意事项：

需提前保存原始数据源
避免在 TextUpdate 中频繁访问数据库
大数据量建议做缓存或延迟搜索

五、大数据量 / 数据库场景建议

不要一次性加载全部数据
使用 TextChanged + 延迟（Timer / Task.Delay）
每次输入长度 ≥ 2 再查询
返回 Top N（如 20 条）

六、常见问题

1. 不显示下拉框？

csharp 复制代码

comboBox1.DroppedDown = true;

2. 中文输入法问题？

使用 TextUpdate 而非 TextChanged
注意输入法组合字符阶段

七、方案选型建议

场景	推荐方案
简单列表	ComboBox 内置
绑定对象	DataSource + DisplayMember
输入提示	TextBox + CustomSource
模糊搜索	自定义过滤
海量数据	延迟 + 服务端查询