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#使用AutoResetEvent实现同步
这篇文章主要为大家详细介绍了C#使用AutoResetEvent实现同步的相关资料，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-03-03
c#实现最简洁的快速排序（你绝对可以看懂）
这篇文章主要给大家介绍了关于利用c#实现如何最简洁的快速排序，实现的方法你绝对可以看懂，文中通过示例代码介绍的非常详细，对大家学习或者使用c#具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-05-05
C# String常用函数的使用详解
这篇文章主要介绍了C# String常用函数的使用详解，帮助大家更好的理解和学习使用c#，感兴趣的朋友可以了解下
2021-04-04
C#处理datagridview虚拟模式的方法
这篇文章主要介绍了C#处理datagridview虚拟模式的方法,实例分析了C#中datagridview的使用技巧,需要的朋友可以参考下
2015-06-06
详解C#代码生成器实现原理
这篇文章主要为大家详细介绍了C#代码生成器实现原理的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
2024-11-11
C#中使用OpenCV的常用函数的常用示例
这篇文章主要介绍了C#中使用OpenCV的常用函数的常用示例,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2021-02-02
C#实现温度转换功能
这篇文章主要为大家详细介绍了C#实现温度转换功能，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-01-01
C#在PDF中绘制不同风格类型的文本方法实例
这篇文章主要给大家介绍了关于C#在PDF中绘制不同风格类型的文本的相关资料，文中通过图文以及示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2018-07-07
C#避免回溯方法心得
这篇文章主要介绍了C#避免回溯方法,以实例的形式讲述了回溯方法的弊端及解决处理方法,是非常实用的技巧,需要的朋友可以参考下
2014-09-09
C# 利用Selenium实现浏览器自动化操作的示例代码
这篇文章主要介绍了C# 利用Selenium实现浏览器自动化操作，帮助大家更好的理解和使用c#，感兴趣的朋友可以了解下
2020-09-09