在C#程序里,当我们想对字节数据进行临时缓冲、转换或者拼接,又不想频繁访问磁盘文件时,MemoryStream是最直接的选择。它是System.IO命名空间下的一个类,本质上是在内存中用字节数组模拟了一个流对象,支持普通的Stream读写接口。

一、MemoryStream的基本创建与写入
MemoryStream最常用的构造方式有两种:无参创建和基于现有字节数组创建。无参构造会先分配一个较小的内部缓冲,随着写入数据增多自动扩容;基于byte数组构造则可以控制初始容量,甚至指定是否允许修改底层数组。
下面的代码演示了如何创建MemoryStream并向其中写入字符串的UTF8字节。注意写入后流的位置会停在末尾,如果接下来要读,必须手动把Position归零。
using System;
using System.IO;
using System.Text;
class Program
{
static void Main()
{
// 无参创建内存流
using (MemoryStream ms = new MemoryStream())
{
string content = " hello memory stream";
byte[] data = Encoding.UTF8.GetBytes(content);
// 写入数据
ms.Write(data, 0, data.Length);
Console.WriteLine("写入后位置: " + ms.Position);
Console.WriteLine("流长度: " + ms.Length);
// 如果想读取,必须把位置设回开头
ms.Position = 0;
byte[] readBuf = new byte[ms.Length];
ms.Read(readBuf, 0, readBuf.Length);
Console.WriteLine("读出内容: " + Encoding.UTF8.GetString(readBuf));
}
}
}
上面的例子用using包裹MemoryStream,这样在离开作用域时会自动调用Dispose释放资源。虽然内存流不占用非托管句柄,但养成释放习惯可以避免大对象在内存里滞留。扩容机制方面,当内部数组不够用时,MemoryStream会新建一个两倍大小的新数组并复制数据,因此在已知数据量时最好用MemoryStream(int capacity)指定初始容量以减少复制。
二、读取与转换的常用方法
除了Read方法,MemoryStream还提供了ToArray和GetBuffer两个容易混淆的接口。ToArray会返回一个新数组,长度刚好等于写入的数据量,安全且常用;GetBuffer返回的是内部整个缓冲数组,可能包含未使用的多余空间,调用者需要结合Length来判断有效数据边界。
在网络编程或序列化场景中,我们经常把对象转成字节再放进内存流。下面示例展示了将int列表写入并用ToArray导出最终字节。
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
class Demo
{
static void Test()
{
MemoryStream ms = new MemoryStream();
// 用BinaryWriter写入多个值
using (BinaryWriter bw = new BinaryWriter(ms, Encoding.UTF8, true))
{
bw.Write(100);
bw.Write(200);
bw.Write("end");
}
// 导出干净字节
byte[] result = ms.ToArray();
Console.WriteLine("总字节数: " + result.Length);
ms.Dispose();
}
}
这里BinaryWriter的构造第三个参数传true,表示离开using时不关闭底层流,这样内存流在writer释放后还能继续使用。很多初学者在这里踩坑:如果没传true,writer释放会顺带关掉MemoryStream,后面再调用Read就会抛ObjectDisposedException。理解好这些包装类的生命周期,是用好MemoryStream的关键。
三、典型使用场景与避坑
MemoryStream常见于图片处理、压缩、加密中间结果暂存。比如把上传的图片在内存里缩略后再存库,就不需要先落地成文件。下面的代码演示用MemoryStream配合DeflateStream做内存压缩。
using System;
using System.IO;
using System.IO.Compression;
using System.Text;
class ZipDemo
{
static void Run()
{
byte[] raw = Encoding.UTF8.GetBytes("重复内容重复内容重复内容");
using (MemoryStream outMs = new MemoryStream())
{
using (DeflateStream ds = new DeflateStream(outMs, CompressionMode.Compress, true))
{
ds.Write(raw, 0, raw.Length);
}
// DeflateStream释放后才真正写完
byte[] compressed = outMs.ToArray();
Console.WriteLine("压缩前: " + raw.Length + " 压缩后: " + compressed.Length);
}
}
}
使用DeflateStream包裹MemoryStream时,必须等压缩流Dispose之后再去取outMs的数据,因为压缩是延迟刷出的。另外MemoryStream不适合存特别大的数据,例如几个GB的内容,因为数组最大长度受限于连续内存和进程可用空间,此时应改用FileStream或分块处理。
还有一个常见误区是反复创建MemoryStream而不释放,在高频接口里会造成GC压力。建议在循环外创建复用,或至少用using保证及时回收。只要理清容量增长、位置重置和包装流关闭顺序,MemoryStream就能成为日常开发里非常好用的内存缓冲工具。
MemoryStreamC#内存流修改时间:2026-08-09 09:45:17