C# System.Buffer 类核心方法详解与字节操作实战

1. Buffer.ByteLength: 计算基元类型数组的总字节数

`Buffer.ByteLength` 方法用于返回指定基元类型数组在内存中占用的总字节数。其计算逻辑非常直观：

• 公式：基元类型的字节长度 × 数组元素个数

该方法比直接查询 `Array.Length * SizeOf(Type)` 更加便捷且类型安全。以下是不同类型数组的长度对比演示：

var bytes = new byte[] { 1, 2, 3 };
var shorts = new short[] { 1, 2, 3 };
var ints = new int[] { 1, 2, 3 };

Console.WriteLine(Buffer.ByteLength(bytes)); // 输出: 1 byte * 3 elements = 3
Console.WriteLine(Buffer.ByteLength(shorts)); // 输出: 2 byte * 3 elements = 6
Console.WriteLine(Buffer.ByteLength(ints)); // 输出: 4 byte * 3 elements = 12

2. Buffer.GetByte: 按字节索引读取数组值

当需要将一组基元类型数据视为连续的字节流进行处理时，可以使用 `Buffer.GetByte(Array array, int index)` 方法。它允许你通过从低位开始计算的字节索引，直接访问数组底层内存中的特定字节。

原理与操作说明

1. 内存组合逻辑：系统将所有数组元素按索引顺序（从低到高）拼接成一个大整数序列。例如，对于两个 int 元素，第一个元素的低位字节排在最前，第二个元素的高位字节排在最后。
2. 索引含义：index 参数表示从这个拼接后的字节序列底部（最低有效字节端）开始的偏移量。

代码示例：获取特定字节

var ints = new int[] { 0x04030201, 0x0d0c0b0a };
// 获取第 2 个字节（从 0 开始计数）
var b = Buffer.GetByte(ints, 2); 
Console.WriteLine(b.ToString("X")); // 输出: 03

解析过程

假设内存布局如下（从左到右为高位到低位，或按字节索引 0,1,2... 排列）：

• 元素 1 (0x04030201)：字节顺序为 01, 02, 03, 04（取决于平台字节序，此处以常见的低位优先展示逻辑索引对应的值）
• 元素 2 (0x0d0c0b0a)：字节顺序为 0a, 0b, 0c, 0d

将两者连接形成的字节流大致为：[0x01, 0x02, 0x03, 0x04, 0x0A, 0x0B, 0x0C, 0x0D]（注：具体字节顺序受运行时环境 ByteOrder 影响，但 Buffer 类屏蔽了细节，直接通过 index 访问）。若 index=2，即访问第三个字节位置，对应值为 0x03。

3. Buffer.SetByte: 按字节索引修改数组值

与 GetByte 相对应，Buffer.SetByte(Array array, int index, byte value) 允许修改基元类型数组中特定字节的值。这在不改变其他字节的前提下，实现了细粒度的内存控制。

代码示例：替换特定字节

var ints = new int[] { 0x04030201, 0x0d0c0b0a };
Buffer.SetByte(ints, 2, 0xff);

Console.WriteLine(ints[0].ToString("X")); // 查看结果变化

操作前后状态分析

• 操作前：整体大整数视图为 0d0c0b0a 04030201
• 操作后：第 2 位字节被替换为 0xFF，变为 0d0c0b0a 04FF0201
• 最终数组结果：{ 0x04FF0201, 0x0D0C0B0A }

此功能常用于构建自定义协议数据包、修改浮点数精度标志或进行位掩码操作优化。

4. Buffer.BlockCopy: 高效字节块复制

Buffer.BlockCopy 是处理不同基元类型间数据转换或内存重叠复制的核心工具。它忽略元素的类型边界，纯粹基于字节偏移量进行复制，因此执行速度远快于逐元素循环赋值。

方法签名

public static void BlockCopy(Array src, int srcOffset, Array dst, int dstOffset, int count)

• src：源数组
• srcOffset：源数组的起始字节偏移量
• dst：目标数组
• dstOffset：目标数组的起始字节偏移量
• count：要复制的字节总数

案例一：同类型数组内的字节块移动

将 arr 中从第 0 个字节开始的前 16 个字节（即前 4 个 int），复制到从第 12 个字节开始的位置（即第 3 个 int 的起始位置）。

int[] arr = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 };
// srcOffset: 0*4, dstOffset: 3*4, count: 4*4 (16 bytes)
Buffer.BlockCopy(arr, 0 * 4, arr, 3 * 4, 4 * 4);

foreach (var e in arr)
{
    Console.WriteLine(e);
}

预期输出：2, 4, 6, 2, 4, 6, 8, 16, 18, 20

解析：原始前 4 个元素 2, 4, 6, 8 的二进制流被整体搬移覆盖了原本位于 8, 10, 12... 开头的部分数据。

案例二：跨类型数据搬运 (byte[] to int[])

这是一个典型的网络包解析或文件头读取场景，将字节数据注入整数数组的特定位置。

var bytes = new byte[] { 0x0a, 0x0b, 0x0c, 0x0d };
var ints = new int[] { 0x00000001, 0x00000002 };

// 从 bytes 的索引 1 (值 0x0b) 开始，取 2 个字节
// 写入 ints 的索引 2 (即第一个 int 的第 3、4 字节位置? 需注意对齐)
Buffer.BlockCopy(bytes, 1, ints, 2, 2);

跨类型复制深度解析

• 源操作：从 bytes 偏移量 1 处提取 2 个字节。由于 bytes[1]=0x0b, bytes[2]=0x0c，提取出的字节块为 0x0b, 0x0c。
• 目标操作：写入 ints 的偏移量 2。这意味着写入到第一个 int 的中间两个字节。
• 结果推导：
  - 原始 ints[0]: 0x00000001
  - 写入 0x0c, 0x0b (注意字节序填充位置) 到偏移量 2。
  - 最终 ints[0] 变为 0x00000000 (高位不变) 或根据具体填充变为 0x0c0b0001 等组合。在本例官方文档语境下，通常理解为将字节流直接覆盖内存区域，结果为 { 0x0C0B0001, 0x00000002 } (具体数值取决于小端序下的地址映射，但逻辑是字节流的精准覆盖)。

总结

掌握 System.Buffer 类的方法，能让你在 C# 中更灵活地处理内存级数据操作。无论是计算缓冲区大小、进行位级调试，还是实现高效的自定义二进制序列化工具，这些底层 API 都能提供比反射或 LINQ 更高的性能和更精确的控制力。