在C#开发场景中，把图片存入数据库是常见需求，尤其适合需要统一管理小体积图片的场景，比如用户头像、商品缩略图等。数据库存储图片时通常将图片转换为二进制数据，再存入对应字段中。
数据库表结构设计
首先需要在数据库中创建存储图片的表，通常使用varbinary类型字段存储二进制图片数据，不同数据库类型略有差异，以下是SQL Server的表结构示例：
CREATE TABLE UserAvatar (
Id INT PRIMARY KEY IDENTITY(1,1),
UserName NVARCHAR(50) NOT NULL,
AvatarData VARBINARY(MAX), -- 存储图片二进制数据
UploadTime DATETIME DEFAULT GETDATE()
)
图片转二进制数组的实现
在C#中，需要先将图片文件转换为字节数组，才能存入数据库。可以通过文件流读取图片内容，再转换为byte[]类型，具体代码如下：
using System.IO;
public byte[] ImageToByteArray(string imagePath)
{
// 判断图片路径是否存在
if (!File.Exists(imagePath))
{
throw new FileNotFoundException("图片文件不存在", imagePath);
}
// 读取图片文件为字节数组
return File.ReadAllBytes(imagePath);
}
使用ADO.NET将图片存入数据库
得到二进制数组后，通过ADO.NET的参数化查询将图片数据插入数据库，避免SQL注入风险，代码如下：
using System.Data.SqlClient;
public void SaveImageToDatabase(string userName, string imagePath, string connectionString)
{
// 将图片转换为字节数组
byte[] imageBytes = ImageToByteArray(imagePath);
// 编写插入SQL语句
string sql = "INSERT INTO UserAvatar (UserName, AvatarData) VALUES (@UserName, @AvatarData)";
using (SqlConnection conn = new SqlConnection(connectionString))
{
conn.Open();
using (SqlCommand cmd = new SqlCommand(sql, conn))
{
// 添加参数
cmd.Parameters.AddWithValue("@UserName", userName);
// 设置二进制参数的类型
cmd.Parameters.Add("@AvatarData", System.Data.SqlDbType.VarBinary).Value = imageBytes;
// 执行插入操作
int rows = cmd.ExecuteNonQuery();
if (rows > 0)
{
Console.WriteLine("图片存入数据库成功");
}
}
}
}
从数据库读取并还原图片
存入数据库后，也可以从数据库中读取二进制数据，再还原为图片文件，实现代码如下：
public void ReadImageFromDatabase(int userId, string savePath, string connectionString)
{
string sql = "SELECT AvatarData FROM UserAvatar WHERE Id = @Id";
using (SqlConnection conn = new SqlConnection(connectionString))
{
conn.Open();
using (SqlCommand cmd = new SqlCommand(sql, conn))
{
cmd.Parameters.AddWithValue("@Id", userId);
// 执行查询获取二进制数据
object result = cmd.ExecuteScalar();
if (result != null && result != DBNull.Value)
{
byte[] imageBytes = (byte[])result;
// 将字节数组写入文件，还原为图片
File.WriteAllBytes(savePath, imageBytes);
Console.WriteLine("图片读取并保存成功");
}
}
}
}
注意事项
- 不建议将大体积图片存入数据库，会占用大量数据库存储空间，影响查询性能，大图片建议存储文件路径，数据库只存路径。
- 二进制字段的长度需要根据图片大小设置，SQL Server中
VARBINARY(MAX)最大支持2GB数据。 - 操作文件流和数据库连接时，务必使用
using语句确保资源正确释放，避免内存泄漏。 - 参数化查询时，二进制参数需要显式指定
SqlDbType.VarBinary类型，避免类型转换错误。