在C#开发中，Base64编码转换是处理数据传输、文件存储场景的常用操作，尤其是字符串和图片的Base64互转需求非常普遍。无论是将文本数据编码后传输，还是把图片转为字符串存储到数据库，都需要用到对应的转换方法。
C#中Base64编码转换基础
Base64是一种基于64个可打印字符来表示二进制数据的编码方式，C#内置了System.Convert类提供基础的Base64转换能力，同时处理图片时需要结合System.Drawing或者System.IO命名空间下的相关类。
字符串与Base64的互转
字符串转Base64需要先明确原始字符串的编码格式，常用的编码格式为UTF8，转换时先将字符串转为字节数组，再通过Convert.ToBase64String方法得到Base64字符串。
以下是字符串转Base64的实现代码：
using System;
using System.Text;
namespace Base64Demo
{
class Program
{
static void Main(string[] args)
{
string originalStr = "这是一段需要转换的测试字符串";
// 将字符串按UTF8编码转为字节数组
byte[] strBytes = Encoding.UTF8.GetBytes(originalStr);
// 将字节数组转为Base64字符串
string base64Str = Convert.ToBase64String(strBytes);
Console.WriteLine("原始字符串：" + originalStr);
Console.WriteLine("Base64编码结果：" + base64Str);
}
}
}
Base64转字符串则是反向操作，先通过Convert.FromBase64String将Base64字符串转为字节数组，再按对应编码格式转为字符串。
Base64转字符串的实现代码如下：
using System;
using System.Text;
namespace Base64Demo
{
class Program
{
static void Main(string[] args)
{
string base64Str = "6L+Z5piv5LiA5q6156yU6KaB6L2s5o2i55qE5rWL6K+V5a2X56ym5Liy";
// 将Base64字符串转为字节数组
byte[] base64Bytes = Convert.FromBase64String(base64Str);
// 将字节数组按UTF8编码转为字符串
string resultStr = Encoding.UTF8.GetString(base64Bytes);
Console.WriteLine("Base64字符串：" + base64Str);
Console.WriteLine("解码结果：" + resultStr);
}
}
}
图片与Base64的互转
图片转Base64需要先将图片文件读取为字节数组，再通过Convert.ToBase64String转换。如果是处理内存中的图片对象，需要先保存到内存流再获取字节数组。
图片转Base64的实现代码如下：
using System;
using System.Drawing;
using System.IO;
namespace Base64Demo
{
class Program
{
static void Main(string[] args)
{
string imagePath = "test.jpg";
// 读取图片文件到字节数组
byte[] imageBytes = File.ReadAllBytes(imagePath);
// 转为Base64字符串
string imageBase64 = Convert.ToBase64String(imageBytes);
Console.WriteLine("图片Base64字符串长度：" + imageBase64.Length);
// 如果是Image对象转Base64
Image img = Image.FromFile(imagePath);
using (MemoryStream ms = new MemoryStream())
{
// 将图片保存到内存流
img.Save(ms, img.RawFormat);
byte[] imgObjBytes = ms.ToArray();
string imgObjBase64 = Convert.ToBase64String(imgObjBytes);
Console.WriteLine("Image对象转Base64完成");
}
}
}
}
Base64转图片则是将Base64字符串转为字节数组后，通过内存流生成图片对象或者保存为图片文件。
Base64转图片的实现代码如下：
using System;
using System.Drawing;
using System.IO;
namespace Base64Demo
{
class Program
{
static void Main(string[] args)
{
string imageBase64 = "这里放图片对应的Base64字符串";
// 将Base64字符串转为字节数组
byte[] imageBytes = Convert.FromBase64String(imageBase64);
// 保存为图片文件
string savePath = "output.jpg";
File.WriteAllBytes(savePath, imageBytes);
Console.WriteLine("Base64转图片文件保存完成");
// 转为内存中的Image对象
using (MemoryStream ms = new MemoryStream(imageBytes))
{
Image img = Image.FromStream(ms);
Console.WriteLine("Base64转Image对象完成，图片尺寸：" + img.Width + "x" + img.Height);
}
}
}
}
转换注意事项
- 字符串转换时要保证编码格式一致，编码和解码使用相同的编码（如都用UTF8），否则会出现乱码。
- 处理图片Base64时，如果Base64字符串包含类似
data:image/jpeg;base64,的前缀，需要先去掉前缀再转换，否则会转换失败。 - 转换过程建议添加异常处理，比如Base64字符串格式错误、文件不存在等情况，避免程序直接崩溃。
- 大文件转换时需要注意内存占用，避免一次性读取过大的文件导致内存溢出。
常见问题解答
转换后的Base64字符串太长怎么办
Base64编码会将3个字节转为4个字符，所以编码后的字符串会比原始数据长约三分之一，这是正常情况，如果需要缩短长度可以考虑先压缩再编码。
转换图片时提示参数无效
通常是Base64字符串不完整或者格式错误，需要检查Base64字符串是否正确，是否包含了多余的前缀或者换行符。
C#Base64编码图片转Base64字符串转Base64修改时间：2026-07-09 14:12:31