Array.ConstrainedCopy(Array, Int32, Array, Int32, Int32) 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

Array.CoreCLR.cs

复制 Array 中的一系列元素（从指定的源索引开始），并将它们粘贴到另一 Array 中（从指定的目标索引开始）。 保证在复制未成功完成的情况下撤消所有更改。

public:
 static void ConstrainedCopy(Array ^ sourceArray, int sourceIndex, Array ^ destinationArray, int destinationIndex, int length);

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

static member ConstrainedCopy : Array * int * Array * int * int -> unit

Public Shared Sub ConstrainedCopy (sourceArray As Array, sourceIndex As Integer, destinationArray As Array, destinationIndex As Integer, length As Integer)

参数

sourceArray

Array

包含要复制的数据的 Array。

sourceIndex

Int32

一个 32 位整数，它表示 sourceArray 中复制开始处的索引。

destinationArray

Array

接收数据的 Array。

destinationIndex

Int32

一个 32 位整数，它表示 destinationArray 中存储开始处的索引。

length

Int32

一个 32 位整数，它表示要复制的元素数目。

例外

ArgumentNullException

sourceArray 为 null。

- 或 -

destinationArray 为 null。

RankException

sourceArray 和 destinationArray 具有不同的秩。

ArrayTypeMismatchException

sourceArray 类型与 destinationArray 类型不同，且不派生自后者。

InvalidCastException

sourceArray 中至少有一个元素无法转换为 destinationArray 的类型。

ArgumentOutOfRangeException

sourceIndex 少于 sourceArray 的第一个维度的下限。

- 或 -

destinationIndex 少于 destinationArray 的第一个维度的下限。

- 或 -

length 小于零。

ArgumentException

length 大于从 sourceIndex 到 sourceArray 末尾的元素数。

- 或 -

length 大于从 destinationIndex 到 destinationArray 末尾的元素数。

注解

sourceArray和 destinationArray 参数必须具有相同的维度数。 该 sourceArray 类型必须与类型相同或派生自该 destinationArray 类型;否则将 ArrayTypeMismatchException 引发 。 与 不同 Copy， ConstrainedCopy 在执行任何操作之前验证数组类型的兼容性。

在多维数组之间复制时，数组的行为类似于一个长一维数组，其中 (行或列) 在概念上是端到端布局的。 例如，如果数组有三行 (或列) 各有四个元素，则复制数组开头的六个元素将复制第一行 (或列) 的所有四个元素，第二行的前两个元素 (或列) 。 若要从第三行 (或列) 的第二个元素开始复制， sourceIndex 必须是第一行 (或列) 的上限加上第二行 (或列) 加两行的长度。

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

[C++]

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

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

如果此方法在复制时引发异常，则 destinationArray 保持不变;因此， ConstrainedCopy 可以在受约束的执行区域中使用 (Cer) 。

此方法是 O (n) 操作，其中 n 为 length。

另请参阅

• Copy
• Clone()
• ReliabilityContractAttribute
• Cer