C# WinForm实现带动态搜索的ComboBox及数据回显问题求助

原代码的问题分析 #

1. 输入文本被重置：在TextChanged事件中清空Items会导致ComboBox的文本被意外重置，打断用户输入流程。
2. 仅存储名称无法关联完整数据：只返回MaterialName字符串，无法获取对应行的其他字段信息，无法满足选中后填充文本框的需求。
3. UI线程阻塞：直接在UI线程执行数据库查询，频繁输入时会导致界面卡顿。
4. 未处理选中事件：缺少选中项后触发的逻辑，无法将对应数据填充到文本框。

解决步骤与代码实现 #

1. 定义Material实体类 #

用来存储数据库中Material表的完整数据，方便后续绑定和获取字段：

public class Material
{
    public int Id { get; set; } // 假设表中有Id主键
    public string MaterialName { get; set; }
    public string Specification { get; set; } // 示例其他字段，根据你的表结构调整
    public decimal Price { get; set; }
    // 添加你需要的其他字段
}

2. 修改异步查询方法 #

将数据库查询改为异步，避免阻塞UI线程，同时返回完整的Material对象：

private async Task<List<Material>> GetSearchSuggestionsAsync(string term)
{
    var suggestions = new List<Material>();
    var searchPattern = $"%{term.Trim()}%";

    using (var connection = new SqlConnection(connectionString))
    {
        await connection.OpenAsync();
        var query = @"SELECT Id, MaterialName, Specification, Price 
                      FROM Material 
                      WHERE MaterialName LIKE @SearchTerm";
        using (var command = new SqlCommand(query, connection))
        {
            command.Parameters.AddWithValue("@SearchTerm", searchPattern);
            using (var reader = await command.ExecuteReaderAsync())
            {
                while (await reader.ReadAsync())
                {
                    suggestions.Add(new Material
                    {
                        Id = reader.GetInt32(reader.GetOrdinal("Id")),
                        MaterialName = reader.GetString(reader.GetOrdinal("MaterialName")),
                        Specification = reader.GetString(reader.GetOrdinal("Specification")),
                        Price = reader.GetDecimal(reader.GetOrdinal("Price"))
                    });
                }
            }
        }
    }
    return suggestions;
}

3. 优化ComboBox的TextChanged事件 #

添加异步处理，避免输入被打断，同时防止重复查询：

private CancellationTokenSource _cts;

private async void comboBoxSearch_TextChanged(object sender, EventArgs e)
{
    var searchTerm = comboBoxSearch.Text.Trim();
    // 取消之前未完成的查询任务
    _cts?.Cancel();
    _cts = new CancellationTokenSource();

    try
    {
        if (!string.IsNullOrEmpty(searchTerm))
        {
            var suggestions = await GetSearchSuggestionsAsync(searchTerm);
            
            // 检查是否当前任务未被取消（避免显示过时的查询结果）
            if (!_cts.Token.IsCancellationRequested)
            {
                // 先记录当前输入的文本，避免清空Items后文本丢失
                var currentText = comboBoxSearch.Text;
                comboBoxSearch.Items.Clear();
                comboBoxSearch.Items.AddRange(suggestions.ToArray());
                // 恢复之前的输入文本
                comboBoxSearch.Text = currentText;
                // 定位光标到文本末尾
                comboBoxSearch.SelectionStart = currentText.Length;
                // 自动展开下拉列表
                comboBoxSearch.DroppedDown = true;
            }
        }
        else
        {
            comboBoxSearch.Items.Clear();
            comboBoxSearch.DroppedDown = false;
        }
    }
    catch (OperationCanceledException)
    {
        // 忽略取消操作的异常
    }
    catch (Exception ex)
    {
        MessageBox.Show($"查询出错：{ex.Message}");
    }
}

4. 处理选中事件填充文本框 #

添加SelectedIndexChanged事件，当用户选中项时，将对应Material的信息填充到窗体的文本框：

private void comboBoxSearch_SelectedIndexChanged(object sender, EventArgs e)
{
    if (comboBoxSearch.SelectedItem is Material selectedMaterial)
    {
        // 根据你的窗体文本框名称调整
        txtId.Text = selectedMaterial.Id.ToString();
        txtName.Text = selectedMaterial.MaterialName;
        txtSpec.Text = selectedMaterial.Specification;
        txtPrice.Text = selectedMaterial.Price.ToString("F2");
    }
}

5. ComboBox的属性设置 #

在设计器中设置ComboBox的以下属性：

• DropDownStyle：设为DropDown（允许用户手动输入文本，同时可选择下拉项）
• AutoCompleteMode：设为None（因为我们手动处理下拉建议，避免系统自动补全冲突）
• AutoCompleteSource：设为None

关键注意事项 #

• connectionString：确保你的数据库连接字符串已正确配置，建议放在配置文件中而非硬编码。
• 字段匹配：根据你的Material表实际字段调整Material类和SQL查询语句。
• 异常处理：可根据需求扩展异常处理逻辑，比如网络异常、数据库连接失败等情况。

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