【C#】Buffer.BlockCopy的使用

wangnaisheng

于 2025-05-03 05:40:12 发布

阅读量882

点赞数 15

分类专栏： C# 文章标签： c#

本文链接：https://blog.csdn.net/wangnaisheng/article/details/147501574

版权

C# 专栏收录该内容

189 篇文章

订阅专栏

Buffer.BlockCopy 是 C# 中的一个方法，用于在数组之间高效地复制字节块。它主要用于操作字节数组（byte[]），但也可以用于其他类型的数组，因为它直接基于内存操作。

以下是关于 Buffer.BlockCopy 的详细说明和使用示例：

语法

src: 源数组。
srcOffset: 从源数组中开始复制的字节偏移量。
dst: 目标数组。
dstOffset: 在目标数组中开始写入的字节偏移量。
count: 要复制的字节数。

public static void BlockCopy(
    Array src,         // 源数组
    int srcOffset,     // 源数组中的起始位置（以字节为单位）
    Array dst,         // 目标数组
    int dstOffset,     // 目标数组中的起始位置（以字节为单位）
    int count          // 要复制的字节数
);

注意事项

数组类型:
- Buffer.BlockCopy 只能用于一维数组（如 byte[], int[], float[] 等）。
- 它不会自动调整数据类型，而是按字节进行复制。例如，复制 int[] 到 byte[] 时，会按照每个 int 占用 4 字节的方式处理。
边界检查:
- 如果超出数组范围，会抛出 ArgumentOutOfRangeException 或 ArgumentException 异常。
性能:
- Buffer.BlockCopy 是一个低级别的方法，性能非常高，适合需要大量数据复制的场景。

示例 1: 从一个 byte[] 复制到另一个 byte[]

byte[] source = { 1, 2, 3, 4, 5 };
byte[] destination = new byte[5];

// 将 source 的前 3 个字节复制到 destination 的第 1 个位置
Buffer.BlockCopy(source, 0, destination, 1, 3);

Console.WriteLine(string.Join(", ", destination)); 
// 输出: 0, 1, 2, 3, 0

示例 2: 从 int[] 复制到 byte[]

int[] source = { 1, 2, 3 }; // 每个 int 占 4 字节
byte[] destination = new byte[12]; // 3 个 int 需要 12 字节

// 将 source 的所有字节复制到 destination
Buffer.BlockCopy(source, 0, destination, 0, 12);

Console.WriteLine(string.Join(", ", destination));
// 输出: 1, 0, 0, 0, 2, 0, 0, 0, 3, 0, 0, 0

示例 3: 从 float[] 复制到 byte[]

float[] source = { 1.0f, 2.0f, 3.0f }; // 每个 float 占 4 字节
byte[] destination = new byte[12]; // 3 个 float 需要 12 字节

// 将 source 的所有字节复制到 destination
Buffer.BlockCopy(source, 0, destination, 0, 12);

Console.WriteLine(string.Join(", ", destination));
// 输出: 0, 0, 128, 63, 0, 0, 0, 64, 0, 0, 64, 64

示例 4: 部分复制

byte[] source = { 1, 2, 3, 4, 5 };
byte[] destination = new byte[5];

// 从 source 的第 2 个字节开始复制 2 个字节到 destination 的第 1 个位置
Buffer.BlockCopy(source, 2, destination, 1, 2);

Console.WriteLine(string.Join(", ", destination));
// 输出: 0, 3, 4, 0, 0

常见用途

数组拼接: 使用 Buffer.BlockCopy 可以高效地将多个数组拼接到一个新数组中。
数据转换: 将不同类型的数据（如 int[]、float[]）转换为 byte[]，或反之。
网络通信: 在网络编程中，经常需要将数据打包成字节数组发送，或者从字节数组解析出原始数据。

与其他方法的对比

方法	特点
`Array.Copy`	支持不同类型的数组，但按元素复制，不适合跨类型操作。
`Buffer.BlockCopy`	按字节复制，适合底层操作，性能更高，但只能用于一维数组。
`MemoryStream`	更高级别的流操作，支持动态扩展，但性能不如 `Buffer.BlockCopy`。

`Buffer.BlockCopy` 的线程安全性

Buffer.BlockCopy 本身是一个静态方法，它不会直接管理线程安全问题。是否支持多线程操作取决于你如何使用它以及目标数组和源数组的访问方式。

分析 `Buffer.BlockCopy`线程安全性

方法本身:
- Buffer.BlockCopy 是一个线程安全的方法，因为它不维护任何内部状态。
- 它的操作是基于传入的数组和偏移量参数进行的，因此多个线程可以同时调用 Buffer.BlockCopy 方法，只要它们操作的数组范围不冲突。
数组共享问题:
- 如果多个线程同时对同一个数组进行读写操作（无论是通过 Buffer.BlockCopy 还是其他方式），可能会导致数据竞争或不一致。
- 例如，如果一个线程正在复制数组的一部分，而另一个线程同时修改该数组的内容，结果可能是不可预测的。
线程安全的关键:
- 确保每个线程操作的数组范围没有重叠。
- 如果必须对共享数组进行并发操作，需要使用同步机制（如 lock 或其他线程同步工具）来保护数组。

多线程使用的注意事项

场景 1: 每个线程操作独立的数组

如果每个线程操作的是完全独立的数组，那么 Buffer.BlockCopy 是完全线程安全的。

byte[] source1 = { 1, 2, 3 };
byte[] destination1 = new byte[3];

byte[] source2 = { 4, 5, 6 };
byte[] destination2 = new byte[3];

// 线程 1
Task.Run(() => Buffer.BlockCopy(source1, 0, destination1, 0, 3));

// 线程 2
Task.Run(() => Buffer.BlockCopy(source2, 0, destination2, 0, 3));

在这种情况下，两个线程互不干扰，Buffer.BlockCopy 可以安全地运行。

场景 2: 多个线程操作同一个数组

如果多个线程操作同一个数组，则需要特别小心，确保不会发生数据竞争。

byte[] sharedArray = new byte[10];

// 线程 1
Task.Run(() => Buffer.BlockCopy(new byte[] { 1, 2, 3 }, 0, sharedArray, 0, 3));

// 线程 2
Task.Run(() => Buffer.BlockCopy(new byte[] { 4, 5, 6 }, 0, sharedArray, 3, 3));

在这个例子中，两个线程分别对 sharedArray 的不同部分进行操作，因此不会发生冲突。

但是，如果两个线程尝试同时写入 sharedArray 的同一部分，就会出现问题。

// 线程 1
Task.Run(() => Buffer.BlockCopy(new byte[] { 1, 2, 3 }, 0, sharedArray, 0, 3));

// 线程 2
Task.Run(() => Buffer.BlockCopy(new byte[] { 4, 5, 6 }, 0, sharedArray, 0, 3));

这时，两个线程都试图将数据写入 sharedArray 的前 3 个字节，最终结果可能是不确定的。

场景 3: 使用锁保护共享数组

如果必须对共享数组进行并发操作，可以通过加锁来确保线程安全：

byte[] sharedArray = new byte[10];
object lockObject = new object();

// 线程 1
Task.Run(() =>
{
    lock (lockObject)
    {
        Buffer.BlockCopy(new byte[] { 1, 2, 3 }, 0, sharedArray, 0, 3);
    }
});

// 线程 2
Task.Run(() =>
{
    lock (lockObject)
    {
        Buffer.BlockCopy(new byte[] { 4, 5, 6 }, 0, sharedArray, 3, 3);
    }
});

通过加锁，可以确保每次只有一个线程能够操作共享数组，从而避免数据竞争。