加载Bitmap到PictureBox时触发“参数无效”异常的原因排查

问题描述 #

调试时在以下代码行触发异常：

pictureBox1.Invoke(new Action(() => pictureBox1.Image = bitmap));

鼠标悬停查看bitmap未发现异常，调整pictureBox1的尺寸和SizeMode也无法解决问题。

异常信息 #

System.ArgumentException
  HResult=0x80070057
  Message=Parameter is not valid.
  Source=System.Drawing
  StackTrace:
   at System.Drawing.Image.get_Width()
   at System.Drawing.Image.get_Size()
   at System.Windows.Forms.PictureBox.ImageRectangleFromSizeMode(PictureBoxSizeMode mode)
   at System.Windows.Forms.PictureBox.OnPaint(PaintEventArgs pe)
   at System.Windows.Forms.Control.PaintWithErrorHandling(PaintEventArgs e, Int16 layer)
   at System.Windows.Forms.Control.WmPaint(Message& m)
   at System.Windows.Forms.Control.WndProc(Message& m)
   at System.Windows.Forms.Control.ControlNativeWindow.OnMessage(Message& m)
   at System.Windows.Forms.Control.ControlNativeWindow.WndProc(Message& m)
   at System.Windows.Forms.NativeWindow.DebuggableCallback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam)

对应方法代码 #

private void DisplayFrameInPictureBox(Mat frame)
{
    // Create a copy of the Mat frame
    using (var frameCopy = new Mat())
    {
        frame.CopyTo(frameCopy);

        // Convert Mat copy to Bitmap
        using (var bitmap = frameCopy.ToBitmap())
        {
            // Display the bitmap in the PictureBox
            if (pictureBox1.InvokeRequired)
            {
                pictureBox1.Invoke(new Action(() => pictureBox1.Image = bitmap));
            }
            else
            {
                pictureBox1.Image = bitmap;
            }
        }
    }
}

异常原因 #

核心问题是Bitmap对象的生命周期管理错误：

• bitmap被包裹在using块中，当代码执行到using块末尾时，对象会被自动调用Dispose()释放资源。
• 虽然通过Invoke将bitmap赋值给pictureBox1.Image，但Invoke是让UI线程异步执行赋值操作。当UI线程实际执行赋值并尝试渲染图片时，原bitmap已经被using块释放，此时访问已释放对象的Width属性就会抛出"Parameter is not valid"的异常。
• 调试时鼠标悬停能看到bitmap的正常信息，是因为此时using块还未结束，对象尚未被释放。

解决办法 #

方法1：移除Bitmap的using语句，手动管理旧图片释放 #

private void DisplayFrameInPictureBox(Mat frame)
{
    using (var frameCopy = new Mat())
    {
        frame.CopyTo(frameCopy);
        Bitmap bitmap = frameCopy.ToBitmap();
        
        if (pictureBox1.InvokeRequired)
        {
            pictureBox1.Invoke(new Action(() => 
            {
                // 释放旧图片避免内存泄漏
                pictureBox1.Image?.Dispose();
                pictureBox1.Image = bitmap;
            }));
        }
        else
        {
            pictureBox1.Image?.Dispose();
            pictureBox1.Image = bitmap;
        }
    }
}

说明：PictureBox会持有bitmap的引用，直到替换新图片或控件被销毁，此时需要在替换时手动释放旧图片资源，避免内存泄漏。

方法2：将Bitmap创建与赋值都放在UI线程（推荐） #

把整个图片处理逻辑移到UI线程执行，彻底避免跨线程生命周期冲突：

private void DisplayFrameInPictureBox(Mat frame)
{
    if (pictureBox1.InvokeRequired)
    {
        pictureBox1.Invoke(new Action(() => DisplayFrameInPictureBox(frame)));
        return;
    }
    
    using (var frameCopy = new Mat())
    {
        frame.CopyTo(frameCopy);
        var bitmap = frameCopy.ToBitmap();
        
        // 释放旧图片
        pictureBox1.Image?.Dispose();
        pictureBox1.Image = bitmap;
    }
}

说明：frameCopy的using块仅释放OpenCV的Mat资源，bitmap由PictureBox持有，不会被提前释放。

方法3：克隆Bitmap后再赋值 #

如果必须在非UI线程创建Bitmap，可以克隆一个独立的Bitmap实例，让using块释放原对象，PictureBox持有克隆后的对象：

private void DisplayFrameInPictureBox(Mat frame)
{
    using (var frameCopy = new Mat())
    {
        frame.CopyTo(frameCopy);
        using (var bitmap = frameCopy.ToBitmap())
        {
            // 克隆生成独立的Bitmap实例
            Bitmap clonedBitmap = new Bitmap(bitmap);
            
            if (pictureBox1.InvokeRequired)
            {
                pictureBox1.Invoke(new Action(() => 
                {
                    pictureBox1.Image?.Dispose();
                    pictureBox1.Image = clonedBitmap;
                }));
            }
            else
            {
                pictureBox1.Image?.Dispose();
                pictureBox1.Image = clonedBitmap;
            }
        }
    }
}

说明：克隆后的Bitmap与原对象完全独立，不受原using块影响，同样需要在替换新图片时释放旧资源。

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