C# MemoryStream中ToArray和GetBuffer的区别小小结

更新时间：2025年07月31日 10:11:41 作者：鲤籽鲲

MemoryStream 中的 GetBuffer() 和 ToArray() 是两个用于获取流数据的方法,核心区别在于数据范围、内存占用和安全性,本文就来介绍一下两者的区别,感兴趣的额可以了解一下

前言

MemoryStream 中的 GetBuffer() 和 ToArray() 是两个用于获取流数据的方法，但它们的核心区别在于 数据范围、内存占用和安全性。

一、核心区别

特性	GetBuffer()	ToArray()
返回内容	返回底层缓冲区的完整数组（包含未使用的空间）。	返回仅包含有效数据的数组（排除未使用的空间）。
内存占用	可能包含大量未使用的空字节（0 填充），占用更多内存。	仅包含实际写入的数据，内存更高效。
性能	速度快（直接返回引用，无需复制）。	速度较慢（需复制数据到新数组）。
安全性	可能暴露未初始化的字节（0 填充），可能导致数据污染或解析错误。	仅返回有效数据，避免未初始化字节的干扰。

二、具体示例

1.GetBuffer()的示例

public class Program
{
    public static void Main(string[] args)
    {
        using (MemoryStream ms = new MemoryStream())
        {
            byte[] data = Encoding.UTF8.GetBytes("test");
            ms.Write(data, 0, data.Length);

            byte[] buffer = ms.GetBuffer(); // 返回长度为 256 的数组（默认初始容量为 256）
            Console.WriteLine(buffer.Length); // 输出：256
            Console.WriteLine(ms.Length);     // 输出：4（实际数据长度）
            Console.WriteLine(BitConverter.ToString(buffer));
            // 输出：74-65-73-74-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00
        }
    }
}

问题：
- 返回的数组包含大量未使用的 0 填充字节（如示例中的 256 - 4 = 252 个 0）。
- 如果直接使用 buffer，可能导致数据解析错误（例如，将 0 误认为有效数据）。

2.ToArray()的示例

public class Program
{
    public static void Main(string[] args)
    {
        using (MemoryStream ms = new MemoryStream())
        {
            byte[] data = Encoding.UTF8.GetBytes("test");
            ms.Write(data, 0, data.Length);

            byte[] bytes = ms.ToArray(); // 返回长度为 4 的数组
            Console.WriteLine(bytes.Length); // 输出：4
            Console.WriteLine(ms.Length);     // 输出：4（实际数据长度）
            Console.WriteLine(BitConverter.ToString(bytes));//输出：74-65-73-74
        }
    }
}

优势：
- 仅返回实际写入的数据（Length 指定的范围），无多余 0 填充。
- 更适合需要精确数据的场景（如序列化、加密、文件传输）。

三、关键场景对比

场景	推荐方法	原因
需要高效访问底层缓冲区（如直接操作内存）	GetBuffer()	避免复制开销，但需确保仅使用有效数据范围。
需要精确数据（如网络传输、文件保存）	ToArray()	确保数据不含未使用的 0，避免解析错误（如 Excel 文件损坏问题）。
流的容量远大于实际数据	ToArray()	避免浪费内存（如示例中 256 字节 vs 4 字节）。
需要避免未初始化字节的干扰	ToArray()	仅返回有效数据，安全性更高。

四、注意事项

1. 异常情况

GetBuffer() 的限制：
- 如果 MemoryStream 是通过 MemoryStream(byte[] buffer, bool writable) 构造函数创建，并且 publiclyVisible 参数未设置为 true，则调用 GetBuffer() 会抛出 UnauthorizedAccessException。
- 解决方案：改用 ToArray() 或确保构造时允许公开访问缓冲区。

2. 容量与长度

Capacity vs Length：
- Capacity 是底层缓冲区的总大小（如默认 256）。
- Length 是实际写入数据的大小（如 4）。
- GetBuffer() 返回的数组长度等于 Capacity，而 ToArray() 返回的数组长度等于 Length。

3. 性能权衡

大数据场景：
- 如果需要频繁操作大容量数据，可先通过 GetBuffer() 直接操作内存，但需严格控制访问范围（如 Length 内）。
小数据或精确性优先：
- 直接使用 ToArray()，避免未初始化字节的干扰。

五、使用建议

优先使用 ToArray()，除非明确需要直接操作底层缓冲区且能确保安全。
在涉及文件导出、网络传输或第三方库解析时，ToArray() 更可靠（如解决 Excel 文件损坏问题）。

通过 TryGetBuffer() 替代 GetBuffer()，避免异常风险。

.NET 4.5+ 引入了 TryGetBuffer() 方法，可安全检查是否允许获取缓冲区：

using (MemoryStream ms = new MemoryStream())
{
    if (ms.TryGetBuffer(out var buffer))
    {
        // 安全获取缓冲区
        byte[] data = new byte[ms.Length];
        Array.Copy(buffer.Array, buffer.Offset, data, 0, (int)ms.Length);
    }
    else
    {
        // 使用 ToArray()
        byte[] data = ms.ToArray();
    }
}

到此这篇关于C# MemoryStream 中 ToArray 和 GetBuffer 的区别的文章就介绍到这了,更多相关C# ToArray GetBuffer内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

C#如何连接数据库
这篇文章主要介绍了C#如何连接数据库问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-08-08
ScriptControl控件执行自定义VBS脚本示例分析
这篇文章主要介绍ScriptControl控件 msscript.ocx msscript.oca执行自定义VBS脚本的示例代码，需要的朋友可以参考下
2013-04-04
DirectoryInfo引用一个相对目录的实例
这种特殊参数在Windows的命令提示符或者“运行”对话框中都可以使用，等价于DOS中的cd命令参数。直接上代码，一看你就懂了：
2013-04-04
C#实现简单的文件加密与解密方式
这篇文章主要介绍了C#实现简单的文件加密与解密方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-01-01
C#/.Net开发chatGPT、openAI的简单步骤
OpenAI处于科技行业下一件大事件的最前沿,具有初创公司史诗般的标志,下面这篇文章主要给大家介绍了关于C#/.Net开发chatGPT和openAI的相关资料,需要的朋友可以参考下
2023-02-02
C#获取某路径文件夹中全部图片或其它指定格式的文件名的实例方法
在本篇文章里小编给大家整理的是关于C#获取某路径文件夹中全部图片或其它指定格式的文件名的实例方法，需要的朋友们参考下。
2019-10-10
C#使用NPOI导出Excel类封装
这篇文章主要为大家详细介绍了C#使用NPOI导出Excel类封装，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-02-02
c#操作Redis的5种基本类型汇总
这篇文章主要给大家介绍了关于c#操作Redis的5种基本类型，文中通过示例代码介绍的非常详细，对大家的学习或者使用C#具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2020-07-07
C#正则表达式实用大全(建议收藏!)
正则表达式是处理字符串的强大工具,拥有独特的语法和独立的处理引擎,下面这篇文章主要给大家介绍了关于C#正则表达式实用大全的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
2023-03-03
十大C#中最具价值的语法糖分享
C#语言是世界最优雅的语言之一,深受广大程序员的喜欢,尤其是其中的一些语法糖,下面就跟随小编一起来了解一下其中10个比较实用的语法糖吧
2024-11-11