ComboBox搜索无匹配项触发System.ArgumentOutOfRangeException异常求助

问题描述 #

项目中使用多个带动态列表的ComboBox，实现了下拉后输入搜索词实时筛选列表的功能。但当搜索无匹配项导致列表为空时，点击控件外部会触发System.ArgumentOutOfRangeException，异常源自ComboBox.ObjectCollection.cs。

复现步骤：

• 点击ComboBox展开下拉列表
• 输入无匹配的内容（如"wwwwww"）
• 立即点击控件外部区域

异常堆栈跟踪：

[Exception] System.Windows.Forms.dll!System.Windows.Forms.ComboBox.ObjectCollection.this[int].get(int index) Line 233 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.ComboBox.SelectedItem.get() Line 1054 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.ComboBox.Text.get() Line 1246 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.ComboBox.WmReflectCommand(ref System.Windows.Forms.Message m) Line 3737 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.ComboBox.WndProc(ref System.Windows.Forms.Message m) Line 3867 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Control.ControlNativeWindow.OnMessage(ref System.Windows.Forms.Message m) Line 67 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Control.ControlNativeWindow.WndProc(ref System.Windows.Forms.Message m) Line 117 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.NativeWindow.Callback(System.IntPtr hWnd, Interop.User32.WM msg, System.IntPtr wparam, System.IntPtr lparam) Line 370 C#
[Exception] System.Windows.Forms.Primitives.dll!Interop.User32.SendMessageW(IHandle hWnd, Interop.User32.WM Msg, System.IntPtr wParam, System.IntPtr lParam) Line 23713 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Control.ReflectMessage(System.IntPtr hWnd, ref System.Windows.Forms.Message m) Line 9918 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Control.WmCommand(ref System.Windows.Forms.Message m) Line 11831 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Control.WndProc(ref System.Windows.Forms.Message m) Line 13045 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.ScrollableControl.WndProc(ref System.Windows.Forms.Message m) Line 1504 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.ContainerControl.WndProc(ref System.Windows.Forms.Message m) Line 2090 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Form.WndProc(ref System.Windows.Forms.Message m) Line 6632 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Control.ControlNativeWindow.OnMessage(ref System.Windows.Forms.Message m) Line 67 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Control.ControlNativeWindow.WndProc(ref System.Windows.Forms.Message m) Line 117 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.NativeWindow.Callback(System.IntPtr hWnd, Interop.User32.WM msg, System.IntPtr wparam, System.IntPtr lparam) Line 370 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.NativeWindow.DefWndProc(ref System.Windows.Forms.Message m) Line 516 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.ComboBox.ComboBoxChildNativeWindow.WndProc(ref System.Windows.Forms.Message m) Line 62 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.NativeWindow.Callback(System.IntPtr hWnd, Interop.User32.WM msg, System.IntPtr wparam, System.IntPtr lparam) Line 370 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Application.ComponentManager.Interop.Mso.IMsoComponentManager.FPushMessageLoop(System.UIntPtr dwComponentID, Interop.Mso.msoloop uReason, void* pvLoopData) Line 346 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Application.ThreadContext.RunMessageLoopInner(Interop.Mso.msoloop reason, System.Windows.Forms.ApplicationContext context) Line 1117 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Application.ThreadContext.RunMessageLoop(Interop.Mso.msoloop reason, System.Windows.Forms.ApplicationContext context) Line 981 C#
[Exception] System.Windows.Forms.dll!System.Windows.Forms.Application.Run(System.Windows.Forms.Form mainForm) Line 1188 C#
[Exception] ComboboxSearch.dll!ComboboxSearch.Program.Main() Line 14 C#
System.Windows.Forms.dll!System.Windows.Forms.NativeWindow.Callback(System.IntPtr hWnd, Interop.User32.WM msg, System.IntPtr wparam, System.IntPtr lparam) Line 381 C#

问题原因 #

从堆栈可以看出，当ComboBox下拉列表被清空后，控件内部的SelectedIndex仍然保留着之前有效列表时的索引值，此时点击外部触发控件失去焦点的逻辑，系统尝试通过该索引访问空集合中的元素，直接导致越界异常。

解决方案 #

方案1：筛选后主动修正选中状态 #

在每次完成列表筛选后，检查列表是否为空，如果为空，手动将SelectedIndex设置为-1，确保没有选中项：

// 假设你的筛选逻辑方法是FilterComboBoxItems
private void FilterComboBoxItems(string searchText)
{
    var filteredItems = originalItems.Where(item => item.Contains(searchText)).ToList();
    comboBox1.Items.Clear();
    comboBox1.Items.AddRange(filteredItems.ToArray());
    
    // 关键：空列表时重置选中状态
    if (comboBox1.Items.Count == 0)
    {
        comboBox1.SelectedIndex = -1;
    }
}

方案2：重写ComboBox拦截异常消息 #

自定义ComboBox控件，重写WndProc方法，拦截会触发异常的WM_REFLECT + WM_COMMAND消息，避免系统尝试访问无效索引：

public class SafeSearchComboBox : ComboBox
{
    protected override void WndProc(ref Message m)
    {
        const int WM_REFLECT = 0x2000;
        const int WM_COMMAND = 0x0111;
        const int CBN_CLOSEUP = 0x0002;

        // 拦截下拉关闭时的反射命令，避免空列表时触发异常
        if (m.Msg == WM_REFLECT + WM_COMMAND)
        {
            int notifyCode = (int)m.WParam >> 16;
            if (notifyCode == CBN_CLOSEUP && Items.Count == 0)
            {
                SelectedIndex = -1;
            }
        }
        base.WndProc(ref m);
    }
}

然后在项目中使用这个自定义控件替代原生ComboBox。

方案3：避免列表完全为空 #

当筛选无匹配项时，添加一个占位项（比如"无匹配结果"），这样列表始终有元素，不会触发越界：

private void FilterComboBoxItems(string searchText)
{
    var filteredItems = originalItems.Where(item => item.Contains(searchText)).ToList();
    comboBox1.Items.Clear();
    
    if (filteredItems.Count == 0)
    {
        comboBox1.Items.Add("无匹配结果");
    }
    else
    {
        comboBox1.Items.AddRange(filteredItems.ToArray());
    }
}

注意后续处理时要排除这个占位项的选中逻辑。

方案4：在Leave事件中修正状态 #

处理ComboBox的Leave事件，在控件失去焦点前检查列表状态，重置选中项：

private void ComboBox1_Leave(object sender, EventArgs e)
{
    var combo = sender as ComboBox;
    if (combo != null && combo.Items.Count == 0)
    {
        combo.SelectedIndex = -1;
    }
}

内容的提问来源于stack exchange，提问作者Abdou.kou