System.Array.Copy 方法 (Array, Int32, Array, Int32, Int32)

上一篇：System.Array.Copy(Array,Array,Int64) 方法下一篇：System.Array.Copy(Array,Int64,Array,Int64,Int64) 方法

方法描述

从指定的源索引开始，复制 Array 中的一系列元素，将它们粘贴到另一 Array 中（从指定的目标索引开始）。长度和索引指定为 32 位整数。

语法定义(C# System.Array.Copy 方法 (Array, Int32, Array, Int32, Int32) 的用法)

public static void Copy(
	Array sourceArray,
	int sourceIndex,
	Array destinationArray,
	int destinationIndex,
	int length
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
sourceArray	System-Array	Array ，它包含要复制的数据。
sourceIndex	System-Int32	一个 32 位整数，它表示 sourceArray 中复制开始处的索引。
destinationArray	System-Array	Array ，它接收数据。
destinationIndex	System-Int32	一个 32 位整数，它表示 destinationArray 中存储开始处的索引。
length	System-Int32	一个 32 位整数，它表示要复制的元素数目。
返回值	void

提示和注释

sourceArray 和 destinationArray 参数必须具有相同的维数。

在多维数组之间复制时，数组像一维长数组那样操作，其中各行（或列）在概念上首尾相连。例如，如果一个数组有三行（或列），每一行（或列）带有四个元素，若要从数组的开始复制六个元素，则会复制第一行（或列）的所有四个元素和第二行（或列）的头两个元素。若要从第三行（或列）的第二个元素开始复制，则 sourceIndex 必须是第一行（或列）的上限加上第二行（或列）的长度再加上 2 之和。

如果 sourceArray 和 destinationArray 重叠，那么在覆盖 destinationArray 之前，此方法的行为好像 sourceArray 的原始值保留在临时位置那样。

[C++]

此方法等效于标准 C/C++ 函数 memmove，而不是 memcpy。

数组可以是引用类型的数组或值类型的数组。按需要执行类型向下转换。

在从引用类型的数组复制到值类型的数组时，每一个元素都要取消装箱，然后再复制。在从值类型的数组复制到引用类型的数组时，每一个元素都要装箱，然后再复制。

在从引用类型或值类型的数组复制到 Object 数组时，会创建 Object 以保存每一个值或引用，然后再复制。在从 Object 数组复制到引用类型或值类型的数组，且不可能进行分配时，将引发 InvalidCastException。

如果 sourceArray 和 destinationArray 都是引用类型的数组或都是 Object 类型的数组，则执行浅表复制。 Array 的浅表副本是包含对与原始 Array 相同的元素的引用的新 Array。不复制元素本身和元素引用的任何内容。相比之下，Array 的深层副本会复制元素和元素直接或间接引用的一切。

如果数组是不兼容的类型，则会引发 ArrayTypeMismatchException。类型兼容性的定义如下：

类型与其本身兼容。

值类型与 Object 兼容，也与该值类型实现的接口类型兼容。只有当值类型直接实现一个接口时，该值类型才算与该接口连接。断开连接的类型不兼容。

如果从源类型复制到目标类型是扩大转换，则两个内部（预定义）值类型兼容。扩大转换从不会丢失信息，而收缩转换可能会丢失信息。例如，将 32 位有符号的整数转换为 64 位有符号的整数是扩大转换，而将 64 位有符号的整数转换为 32 位有符号的整数是收缩转换。有关转换的更多信息，请参见 Convert。

非内部（用户定义）值类型只与其本身兼容。

枚举具有到 Enum 的隐式转换，也有到其基础类型的隐式转换。

如果 sourceArray 中的每个元素都要求向下转换（例如，从基类转换到派生类或从接口转换到对象），且一个或多个元素无法强制转换为 destinationArray 中的对应类型，则会引发 InvalidCastException。

如果此方法在复制时引发异常，则 destinationArray 的状态未定义。

此方法的运算复杂度为 O(n)，其中 n 是 length。