C# 实现图片与字节流互转及在网页中显示

拾柒

发布时间：2026-10-13| 4人浏览过

原创

探讨如何使用 C# 语言将图片文件与字节流数据进行双向转换，并展示在 ASP.NET Web 应用中如何输出图像到浏览器，包含核心代码实现与 HTTP Handler 的处理逻辑。

图片与字节流的转换原理

在 .NET 环境中，Image 对象是处理图形数据的基础。要将图片转换为便于存储或网络传输的格式，通常将其转换为字节数组（byte[]）。反之，若要将接收到的字节数据还原为可见图像，则需利用内存流创建新的 Image 实例。这一过程主要依赖 System.IO 命名空间下的类来完成数据的读写操作。

C# 转换核心代码实现

为了实现通用的转换功能，可以封装一个静态工具类。该工具类应提供三个主要方法：将现有 Image 对象转为字节流、将字节流还原为 Image 对象，以及直接从本地路径读取图片为字节流。

using System;
using System.Drawing;
using System.IO;

namespace Microsoft.Form.Base
{
    class ImageToByte
    {
        /// <summary>
        /// 将 Image 对象转换为 JPEG 格式的字节流
        /// </summary>
        public static byte[] ImgToByt(Image img)
        {
            using (MemoryStream ms = new MemoryStream())
            {
                // 指定保存格式为 Jpeg，确保跨平台兼容性
                img.Save(ms, System.Drawing.Imaging.ImageFormat.Jpeg);
                return ms.ToArray();
            }
        }

        /// <summary>
        /// 将字节流还原为 Image 对象
        /// </summary>
        public static Image BytToImg(byte[] byt)
        {
            using (MemoryStream ms = new MemoryStream(byt))
            {
                return Image.FromStream(ms);
            }
        }

        /// <summary>
        /// 根据图片物理路径返回字节流
        /// </summary>
        private static byte[] GetImageByte(string imagePath)
        {
            using (FileStream fs = new FileStream(imagePath, FileMode.Open))
            {
                byte[] imgByte = new byte[fs.Length];
                fs.Read(imgByte, 0, imgByte.Length);
                return imgByte;
            }
        }
    }
}

上述代码中需要注意：ImgToByt 方法通过 Save 函数显式指定了 Jpeg 格式，这有助于统一输出标准。在从路径读取时，使用 FleStream 配合数组长度读取是基础做法，但在现代 C# 开发中也可考虑使用 File.ReadAllBytes() 简化调用。

在 Web 页面中显示字节流图片

转换得到的字节流通常不直接生成临时文件，而是通过 HTTP 响应（Response）直接写入浏览器。这要求服务器端设置正确的 Content-Type 并写入二进制内容。

第1步：直接在 Page 事件中输出

如果在传统的 ASP.NET WebForms 页面中，可以在 Page_Load 或其他事件处理器中直接操作 Response 对象。首先清空缓冲区，设置 MIME 类型，然后将字节数组的内容写入响应流。

适用场景： 简单的图片调试或无需缓存的动态图像请求。

// 假设 result 为已获取的字节数组
byte[] result = ...; 
System.IO.MemoryStream ms = new MemoryStream(result, 0, result.Length); 
Response.ClearContent();
// 注意根据实际图片格式修改 ContentType，如 image/jpeg 或 image/png
Response.ContentType = "image/gif"; 
Response.BinaryWrite(ms.ToArray());
Response.End();

第2步：使用自定义 HttpHandler 处理图片

更规范的做法是实现一个实现了 IHttpHandler 接口的处理程序。这种方式可以将图片处理逻辑与业务逻辑分离，且能更好地管理资源。以下是一个基于 CategoryID 查询并返回对应图片流的示例：

<%@ WebHandler Language="C#" Class="Handler" %>
using System.Web;
using System.IO;

public class Handler : IHttpHandler {
 public void ProcessRequest (HttpContext context) {
     string categoryIdStr = context.Request.QueryString["CategoryID"];
     int CategoryID = int.Parse(categoryIdStr);
 
     // 模拟获取数据库中的图片流
     Stream stream = CategoriesPicture.GetPicture(CategoryID);
 
     if (stream != null) {
         int buffersize = (int)stream.Length;
         System.Byte[] buffer = new System.Byte[buffersize];
         int count = stream.Read(buffer, 0, buffersize);
 
         if (count != 0) {
             context.Response.OutputStream.Write(buffer, 0, count);
         }
     }
 }
 
 public bool IsReusable {
     get { return false; }
 }
}

该方法通过读取 Stream 的大小，预先分配 Buffer 并一次性读取写入 OutputSream。在实际生产环境中，建议使用 PipeStream 或异步流复制方法以避免内存溢出，并确保正确设置对应的 ContentType。

关键注意事项

内存释放： 在处理大量图片转换时，务必使用 using 语句包裹 MemoryStream 和 FileStream 等未托管资源，防止内存泄漏。
格式匹配： Response.ContentType 必须与图片的实际编码格式（JPEG、PNG、GIF）严格一致，否则浏览器可能无法解析或显示异常。
路径处理： getImageByte 方法依赖于绝对路径。在 Web 应用程序中，建议结合 Server.MapPath() 将虚拟路径转换为物理路径以确保文件可访问性。