Tablets.CopyTo 方法

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

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

语法

声明
Public Sub CopyTo ( _
    array As Array, _
    index As Integer _
)
用法
Dim instance As Tablets
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 对象中,复制顺序与枚举数循环访问 Tablets 的顺序相同。

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

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

  • index 参数小于零。

  • array 参数是多维的。

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

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

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

此方法是同步的。

示例

此示例使用 Tablets 集合的全部内容填充 Tablet 对象数组的一部分,并从目标数组 allTabletsArray 的元素 1(从零开始的数组中的第二个元素)开始填充,而将目标数组的第一个元素(索引为 0)留空。注意,只要构造 Tablets 集合就会用可用的 Tablet 填充该集合。

Dim allTablets As New Tablets()
' create an array that has one more element than allTablets
Dim allTabletsArray(allTablets.Count) As Tablet
allTablets.CopyTo(allTabletsArray, 1)
Tablets allTablets = new Tablets();
// create an array that has one more element than allTablets
Tablet[] allTabletsArray = new Tablet[allTablets.Count + 1];
allTablets.CopyTo(allTabletsArray, 1);

平台

Windows Vista

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

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

Tablets 类

Tablets 成员

Microsoft.Ink 命名空间