Strokes.CopyTo 方法

从指定的目标数组索引处开始,将当前 Strokes 集合的所有元素复制到指定的一维数组中。

命名空间:  Microsoft.Ink
程序集:  Microsoft.Ink(在 Microsoft.Ink.dll 中)

语法

声明
Public Sub CopyTo ( _
    array As Array, _
    index As Integer _
)
用法
Dim instance As Strokes
Dim array As Array
Dim index As Integer

instance.CopyTo(array, index)
public void CopyTo(
    Array array,
    int index
)
public:
virtual void CopyTo(
    Array^ array, 
    int index
) sealed
public final void CopyTo(
    Array array,
    int index
)
public final function CopyTo(
    array : Array, 
    index : int
)

参数

  • array
    类型:System.Array
    用作要将集合中的元素复制到的目标的一维数组。该数组必须具有从零开始的索引。
  • index
    类型:System.Int32
    数组参数中从零开始的索引,将从该索引处开始复制。

实现

ICollection.CopyTo(Array, Int32)

备注

这些元素将被复制到 Array 对象中,复制顺序与枚举数循环访问 Strokes 的顺序相同。

在下列情况下会引发异常:

  • array 参数为 nullnull 引用(在 Visual Basic 中为 Nothing)(在 Microsoft Visual Basic .NET 中为 Nothing)引用。

  • index 参数小于零。

  • array 参数是多维的。

  • index 参数等于或大于 array 参数的长度。

  • 集合中元素的个数大于从 index 参数到目标 array 参数末尾之间的可用空间。

集合类型将自动强制转换为目标 array 参数的类型。但是,此方法仅将元素复制到与集合中的元素类型相同的数组中,或者复制到 Object 类型的数组中。尝试复制到其他类型的数组将导致引发 InvalidCastException 异常。

此方法不是同步的。

示例

此 C# 示例使用 Ink.Strokes 集合的全部内容填充 Stroke 对象数组的一部分,并从目标数组 theCopies 的元素 1(从零开始的数组中的第二个元素)开始填充,而将目标数组的第一个元素(索引为 0)留空。

Stroke[] theCopies = new Stroke[theInkCollector.Ink.Strokes.Count + 1];
theInkCollector.Ink.Strokes.CopyTo(theCopies, 1);

此 Visual Basic .NET 示例使用 Ink.Strokes 集合的全部内容填充 Stroke 对象数组的一部分,并从目标数组 theCopies 的元素 1(从零开始的数组中的第二个元素)开始填充,而将目标数组的第一个元素(索引为 0)留空。

Dim theCopies(e.Stroke.ExtendedProperties.Count) As Stroke
e.Stroke.ExtendedProperties.CopyTo(theCopies, 1)

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

Strokes 类

Strokes 成员

Microsoft.Ink 命名空间