DataGridViewImageColumn缩略图显示异常问题求助

问题原因分析 #

1. 控件初始化时机冲突：构造函数中直接设置DataSource时，DataGridView的控件生命周期尚未完成（比如控件句柄还未创建），此时给单元格赋值Bitmap，控件无法正确完成图片渲染；而Load事件触发时，窗体和所有控件已完成初始化，所以硬编码场景能正常显示。
2. DataSourceChanged事件执行时机问题：构造函数中设置数据源会立即触发DataSourceChanged事件，此时控件未完全就绪，修改单元格值的操作可能不会被DataGridView正确识别和保留。
3. 直接修改单元格值的不可靠性：在控件未初始化完成时，直接修改DataGridViewImageCell.Value，后续的绑定流程可能覆盖该值，或者控件无法触发重绘逻辑。

解决方案 #

方案1：延迟执行图片赋值逻辑（适配DataSourceChanged场景） #

使用BeginInvoke让图片赋值代码在UI线程空闲时执行，确保控件已完全初始化：

private void dataGridView1_DataSourceChanged(object sender, EventArgs e)
{
    BeginInvoke(new Action(() =>
    {
        foreach (DataGridViewRow row in dataGridView1.Rows)
        {
            if (row.IsNewRow) continue; // 跳过自动生成的新行
            string path = row.Cells["pathCol"].Value.ToString();

            int THUMB_SIZE = 256;
            Bitmap thumbnail = WindowsThumbnailProvider.GetThumbnail(
               path, THUMB_SIZE, THUMB_SIZE, ThumbnailOptions.None);
            (row.Cells["imageCol"] as DataGridViewImageCell).Value = thumbnail;

            pictureBox1.Image = thumbnail;
        }
        dataGridView1.Refresh(); // 手动触发控件重绘
    }));
}

方案2：直接在DataTable中包含Image列（推荐） #

修改数据源结构，提前将图片存入DataTable，让DataGridView通过绑定直接读取图片，避免事后修改单元格：

public DataGridViewImage(string path)
{
    InitializeComponent();
    
    DataTable table = new DataTable();
    table.Columns.Add("path", typeof(string));
    table.Columns.Add("thumbnail", typeof(Image)); // 添加Image类型列

    int THUMB_SIZE = 256;
    Bitmap thumbnail = WindowsThumbnailProvider.GetThumbnail(
       path, THUMB_SIZE, THUMB_SIZE, ThumbnailOptions.None);

    DataRow row = table.NewRow();
    row["path"] = path;
    row["thumbnail"] = thumbnail;
    table.Rows.Add(row);

    dataGridView1.DataSource = table;        
}

之后确保DataGridView的imageCol列绑定到thumbnail字段即可。

方案3：配置DataGridViewImageColumn的属性 #

确保图片列的类型和布局设置正确：

// 在InitializeComponent后或Form_Load中添加
dataGridView1.Columns["imageCol"].ValueType = typeof(Image);
(dataGridView1.Columns["imageCol"] as DataGridViewImageColumn).ImageLayout = DataGridViewImageCellLayout.Zoom;

方案4：使用CellFormatting事件动态生成图片 #

在单元格需要显示时才生成图片，既高效又能避免初始化时机问题：

// 先绑定事件（比如在窗体构造函数中）
dataGridView1.CellFormatting += dataGridView1_CellFormatting;

// 事件处理逻辑
private void dataGridView1_CellFormatting(object sender, DataGridViewCellFormattingEventArgs e)
{
    if (e.ColumnIndex == dataGridView1.Columns["imageCol"].Index 
        && !dataGridView1.Rows[e.RowIndex].IsNewRow)
    {
        string path = dataGridView1.Rows[e.RowIndex].Cells["pathCol"].Value.ToString();
        if (!string.IsNullOrEmpty(path))
        {
            int THUMB_SIZE = 256;
            Bitmap thumbnail = WindowsThumbnailProvider.GetThumbnail(
               path, THUMB_SIZE, THUMB_SIZE, ThumbnailOptions.None);
            e.Value = thumbnail;
            e.FormattingApplied = true; // 标记已完成格式化，跳过默认逻辑
        }
    }
}

测试验证 #

对于OpenFileDialog场景，选择文件后更新DataTable对应行的path值，或直接调用dataGridView1.Refresh()触发CellFormatting事件，即可正常显示图片。

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