C# 中的 Array.ConstrainedCopy() 方法

在本文中，我们将讨论 C# 中的 Array.ConstrainedCopy() 方法及其语法、参数和示例。

什么是 Array.ConstrainedCopy()？

Array.ConstrainedCopy() 方法用于将一系列元素从一个数组复制到另一个数组，同时确保操作正确执行并在指定边界内。当处理数组时，此方法非常有用，其中保持内存安全和避免缓冲区溢出至关重要。

语法

它具有以下语法：

参数

• sourceArray：它是将从中复制元素的源数组。
• sourceIndex：开始复制的 sourceArray 初始索引。
• destinationArray：复制元素在目标数组内的位置。
• destinationIndex：在 destinationArray 中开始复制的索引。
• length：必须从源数组复制到目标数组的元素数量。

示例

让我们举一个例子来说明 C# 中的 Array.ConstrainedCopy() 方法。

输出

Destination Array:
14
25
32
47
85
93

说明

本例演示如何使用 Array.ConstrainedCopy() 方法在数组之间安全地复制元素，同时处理整个过程中可能发生的任何潜在异常。

异常

Array.ConstrainedCopy() 方法有几个异常。其中一些异常如下：

1. ArgumentNullException

如果 destinationArray 或 sourceArray 为 null，则会发生此异常。

示例

让我们举一个例子来说明 C# 中使用 ArgumentNullException 的 Array.ConstrainedCopy() 方法。

输出

An error occurred: The value cannot be null.
Parameter name: sourceArray

2. ArgumentOutOfRangeException

如果 length 小于 0，或者 sourceIndex 小于 sourceArray 第一个维度的下限，或者 destinationIndex 小于 destinationArray 第一个维度的下限。

示例

让我们举一个例子来说明 C# 中使用 ArgumentOutOfRangeException 的 Array.ConstrainedCopy() 方法。

输出

Unhandled Exception:
System.ArgumentException: length

说明

正如这些示例所示，当 "Array.ConstrainedCopy()" 方法遇到空数组或长度或索引参数不在允许范围内时，它会抛出异常。

3. RankException

如果 sourceArray 和 destinationArray 的秩不同。

示例

输出

Error Occurred: Only single-dimension arrays are supported here.

说明

在本例中，此代码演示了如何在使用 'Array.ConstrainedCopy()' 方法在不同秩的数组之间传输元素时，在 C# 中处理 RankException。

4. ArgumentException

假设 length 超过了从 destinationIndex 到 destinationArray 末尾的元素数量。在这种情况下，length 应该超过从 sourceIndex 到 sourceArray 末尾的元素数量 '或'。

示例

输出

Error Occurred!: length