VB.NET WinForm中DataGridView绑定数据源后列异常变化问题排查

我在开发VB.NET WinForm程序时，通过代码为DataGridView动态创建列并配置DataPropertyName属性，核心代码如下：

MyDataGrid.ColumnCount = 13

MyDataGrid.Columns(0).Name = "MRN"
MyDataGrid.Columns(0).HeaderText = "MRN"
MyDataGrid.Columns(0).DataPropertyName = "med_rec_nbr"

MyDataGrid.Columns(1).Name = "LastName"
MyDataGrid.Columns(1).HeaderText = "Last Name"
MyDataGrid.Columns(1).DataPropertyName = "last_name"

MyDataGrid.Columns(2).Name = "FirstName"
MyDataGrid.Columns(2).HeaderText = "First Name"
MyDataGrid.Columns(2).DataPropertyName = "first_name"

MyDataGrid.Columns(3).Name = "DateOfBirth"
MyDataGrid.Columns(3).HeaderText = "Date of Birth"
MyDataGrid.Columns(3).DataPropertyName = "date_of_birth"

但将SQL Server返回的DataTable设置为数据源后，DataGridView的列发生了异常变化（设置前列为手动定义的MRN、Last Name等13列；设置后变为数据源原生列，列名、顺序均被修改），设置数据源的代码如下：

Dim dtResults As DataTable
dtResults = GetSQLData(ID)

MyDataGrid.DataSource = dtResults

其他DataGridView控件未出现此问题，以下是具体原因分析与排查方向：

核心原因 #

最可能的原因是当前DataGridView的AutoGenerateColumns属性未关闭。该属性默认值为True，当设置DataSource时，控件会自动根据数据源的列结构重新生成列，直接覆盖你手动创建的列。其他正常的DataGridView大概率已经将此属性设为False。

排查与解决要点 #

• 检查AutoGenerateColumns属性：
  确认当前出问题的DataGridView的AutoGenerateColumns是否为False。可以在设计器的属性面板中查看，也可以在设置数据源之前通过代码强制设置：

  MyDataGrid.AutoGenerateColumns = False
  

  必须保证此设置在DataSource = dtResults之前执行。

• 确认列创建与数据源设置的顺序：
  确保手动创建并配置列的代码，在设置DataSource之前完全执行完毕。如果先绑定数据源再创建列，会导致手动列被自动生成的列覆盖。

• 校验DataTable与手动列的匹配性：
  检查GetSQLData(ID)返回的DataTable的列名，是否与手动列的DataPropertyName完全匹配（注意VB.NET字符串比较默认不区分大小写，但建议保持完全一致避免潜在问题）。若存在拼写错误，会导致手动列无法绑定数据，甚至触发控件的异常列行为。

• 排查其他修改列的代码：
  检查是否有其他代码（比如DataBindingComplete事件处理、后续的列调整逻辑）在设置数据源后修改了列结构，导致列发生变化。

• 对比正常DataGridView的配置：
  将出问题的DataGridView与正常控件的属性、代码逻辑做对比，重点看AutoGenerateColumns设置、数据源绑定顺序、列配置方式是否存在差异。

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