在 C# 中将图片转换为 Base64 字符串非常实用,尤其是在需要通过 JSON 或 API 传输图像数据时。实现过程简单明了:读取图片文件为字节数组,再使用 Convert.ToBase64String 方法编码即可。
1. 使用 FileStream 读取图片并转为 Base64
这是最常见的方式,适用于本地图片文件。
string imagePath = @"C:\images\example.jpg"; // 图片路径
byte[] imageBytes;
<p>using (FileStream fileStream = new FileStream(imagePath, FileMode.Open, FileAccess.Read))
{
using (BinaryReader binaryReader = new BinaryReader(fileStream))
{
imageBytes = binaryReader.ReadBytes((int)fileStream.Length);
}
}</p><p>string base64String = Convert.ToBase64String(imageBytes);
Console.WriteLine("Base64 字符串: " + base64String);</p>2. 使用 File.ReadAllBytes 简化读取
更简洁的方法,适合小文件。
string imagePath = @"C:\images\example.png";
byte[] imageBytes = File.ReadAllBytes(imagePath);
string base64String = Convert.ToBase64String(imageBytes);
<p>// 可选:添加 Data URI 前缀(用于网页显示)
string dataUri = $"data:image/png;base64,{base64String}";</p>3. 获取图片 MIME 类型动态生成 Data URI
如果你希望生成通用的 Data URI,可以按扩展名判断类型。
public static string ImageToBase64(string imagePath)
{
if (!File.Exists(imagePath))
throw new FileNotFoundException("图片未找到", imagePath);
<pre class='brush:php;toolbar:false;'>byte[] imageBytes = File.ReadAllBytes(imagePath);
string mimeType = GetMimeType(imagePath);
string base64 = Convert.ToBase64String(imageBytes);
return $"data:{mimeType};base64,{base64}";}
private static string GetMimeType(string path) { string ext = Path.GetExtension(path).ToLower(); return ext switch { ".jpg" or ".jpeg" => "image/jpeg", ".png" => "image/png", ".gif" => "image/gif", ".bmp" => "image/bmp", ".webp" => "image/webp", _ => "image/unknown" }; }
4. 注意事项与建议
转换前注意以下几点,避免常见问题:
大图片会生成很长的 Base64 字符串,影响性能,建议压缩或限制尺寸 确保程序有读取图片文件的权限 Base64 编码后数据体积约增加 33%,传输时考虑效率 Web 应用中使用 Data URI 时,部分旧浏览器有长度限制基本上就这些。C# 图片转 Base64 的方法不复杂,关键是正确读取字节流并编码。根据实际场景选择合适的方式即可。
