picturebox.image

### C# WinForms PictureBox Image 属性用法

在C# WinForms应用程序中，`PictureBox` 控件用于显示图像。设置 `PictureBox` 的 `Image` 属性可以实现这一功能[^1]。

#### 设置静态图片
通过编程方式加载并显示一张本地磁盘上的图片：

// 加载指定路径的图片文件
Image image = Image.FromFile("background.jpg");

// 创建一个新的 PictureBox 实例
PictureBox pictureBox1 = new PictureBox();

// 设置位置和大小以覆盖整个窗体区域
pictureBox1.Location = new Point(0, 0);
pictureBox1.Size = new Size(this.ClientSize.Width, this.ClientSize.Height);

// 将加载好的图片赋给 PictureBox 的 Image 属性
pictureBox1.Image = image;

// 把 PictureBox 添加到当前窗口控件集合里
this.Controls.Add(pictureBox1);

这段代码展示了如何从文件系统读取一幅位图，并将其作为 `PictureBox` 中的内容呈现出来。

#### 动态更新图片
如果希望程序运行过程中能够动态改变所显示的图片，则可以通过修改 `Image` 属性来完成:

private void ChangePicture(string imagePath)
{
    try 
    {
        // 清除现有资源释放内存
        pictureBox1.Image?.Dispose();
        
        // 更新新的图片源
        pictureBox1.Image = Image.FromFile(imagePath);
    }
    catch (Exception ex) 
    {
        MessageBox.Show($"无法更改图片: {ex.Message}");
    }
}

此函数接收一个字符串参数表示新图片的位置，在执行前会先清理旧有的图形对象以防泄露，之后再尝试打开并应用新的图像数据[^3]。