C# WinForms文本框AutoComplete多选功能实现技术咨询

嘿，我来帮你搞定这个多值自动完成的需求！默认的WinForms TextBox自动完成只支持单值输入，不过我们可以通过自定义逻辑，让它支持多值选择——核心思路是拆分用户输入的文本，只对最后一个未完成的项做自动匹配，下面是具体的实现步骤和代码：

核心思路 #

1. 定义一个分隔符（比如, ）来区分多个选中的项
2. 在TextChanged事件中，拆分当前文本，提取最后一个待输入的片段
3. 用这个片段过滤原始数据源，更新自动完成列表
4. 处理用户选中项的事件，自动添加分隔符，方便继续输入下一个项

完整实现代码 #

首先，修改你的窗体类，添加分隔符定义、更新自动完成配置，并实现事件逻辑：

public partial class FormLookup : Form
{
    AutoCompleteStringCollection source = new AutoCompleteStringCollection();
    // 定义多值分隔符，可根据需求修改（比如"; "、" "等）
    private const string Separator = ", ";

    public FormLookup()
    {
        InitializeComponent();
        // 初始化原始数据源
        source.Add("Test");
        source.Add("TestItem");
        source.Add("TestValue");
        source.Add("Example");
        source.Add("ExampleItem");
        
        // 配置自动完成模式：建议+追加（也可只选AutoCompleteMode.Suggest）
        textBox1.AutoCompleteMode = AutoCompleteMode.SuggestAppend;
        textBox1.AutoCompleteSource = AutoCompleteSource.CustomSource;
        textBox1.AutoCompleteCustomSource = source;
        
        // 绑定KeyDown事件，处理选中项后的分隔符添加
        textBox1.KeyDown += textBox1_KeyDown;
    }

    private void textBox1_TextChanged(object sender, EventArgs e)
    {
        var textBox = sender as TextBox;
        if (textBox == null) return;

        // 获取光标位置前的文本，拆分已完成项和待输入片段
        int cursorPos = textBox.SelectionStart;
        string currentText = textBox.Text.Substring(0, cursorPos);
        int lastSeparatorIndex = currentText.LastIndexOf(Separator);

        // 提取最后一个待输入的内容
        string partialInput = lastSeparatorIndex >= 0 
            ? currentText.Substring(lastSeparatorIndex + Separator.Length).Trim() 
            : currentText.Trim();

        // 如果待输入内容为空，恢复完整数据源
        if (string.IsNullOrEmpty(partialInput))
        {
            textBox.AutoCompleteCustomSource = source;
            return;
        }

        // 过滤数据源，只保留匹配待输入片段的项（忽略大小写）
        var filteredSource = new AutoCompleteStringCollection();
        foreach (string item in source)
        {
            if (item.StartsWith(partialInput, StringComparison.OrdinalIgnoreCase))
            {
                filteredSource.Add(item);
            }
        }

        // 更新自动完成列表
        textBox.AutoCompleteCustomSource = filteredSource;
    }

    private void textBox1_KeyDown(object sender, KeyEventArgs e)
    {
        var textBox = sender as TextBox;
        if (textBox == null) return;

        // 当用户按Tab/Enter选中自动完成项时，自动添加分隔符
        if ((e.KeyCode == Keys.Tab || e.KeyCode == Keys.Enter) && textBox.AutoCompleteCustomSource.Count > 0)
        {
            // 避免重复添加分隔符
            if (!textBox.Text.EndsWith(Separator))
            {
                textBox.Text += Separator;
                textBox.SelectionStart = textBox.Text.Length;
                e.SuppressKeyPress = true; // 阻止默认的Tab/Enter行为（比如切换控件）
            }
        }
    }
}

关键细节说明 #

• 分隔符自定义：你可以把Separator常量改成任何你需要的符号，比如分号、空格等
• 匹配规则：当前代码用的是StartsWith忽略大小写匹配，你也可以改成Contains实现包含匹配，或者精确匹配
• 自动完成模式：AutoCompleteMode.SuggestAppend会在显示建议的同时自动补全匹配的内容，如果你只想显示建议列表，改成AutoCompleteMode.Suggest即可
• 用户体验优化：KeyDown事件的处理是为了让用户选中项后自动添加分隔符，不用手动输入，提升操作流畅度

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