设置DataGridViewComboBoxColumn标题时触发索引越界错误

核心原因 #

问题出在Designer代码的执行顺序上：你设置gridComboBox1.HeaderText的代码，实际执行时间早于this.dgv1.Columns.AddRange(...)把列加入DataGridView的代码。虽然你在文件里看到AddRange的代码，但Visual Studio生成的Designer代码逻辑中，控件属性初始化语句可能排在列添加语句之前——这时候ComboBox列还不属于DataGridView的Columns集合，修改HeaderText会触发索引越界错误。

解决方法 #

方法1：手动调整Designer代码顺序 #

打开窗体的Designer.cs文件，找到相关代码段，把设置HeaderText的语句移到AddRange之后：

// 修改后正确顺序
this.dgv1.Columns.AddRange(new System.Windows.Forms.DataGridViewColumn[] { this.gridComboBox1 });
this.gridComboBox1.HeaderText = "Options";

注意：下次在Visual Studio设计器中修改该控件属性时，代码顺序可能被重置，需重复调整。

方法2：在构造函数中初始化标题（推荐） #

放弃在Designer里设置HeaderText，转而在窗体构造函数的InitializeComponent()之后设置：

public YourFormName()
{
    InitializeComponent();
    // 此时列已被添加到DataGridView，可安全修改标题
    gridComboBox1.HeaderText = "Options";
}

这种方法不受Designer代码自动生成的影响，稳定性更高。

方法3：创建列时直接指定标题 #

如果是手动创建ComboBox列（而非设计器拖放），可以在实例化列时就设置HeaderText，再添加到DataGridView：

// 在构造函数或合适的初始化方法中执行
DataGridViewComboBoxColumn comboCol = new DataGridViewComboBoxColumn();
comboCol.HeaderText = "Options";
comboCol.Name = "gridComboBox1";
dgv1.Columns.Add(comboCol);

关于Form.Load事件报错的说明 #

如果在Load事件中设置仍报错，大概率是你用了索引访问列（比如dgv1.Columns[0].HeaderText），此时列的索引位置可能未正确初始化。改用直接通过列对象（gridComboBox1.HeaderText）或列名（dgv1.Columns["gridComboBox1"].HeaderText）访问即可避免。

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