ContextNodeCollection.CopyTo 方法

  • 项目

使用指定的目标数组的索引，将当前 ContextNodeCollection 的所有元素复制到指定的一维数组中。

命名空间：  System.Windows.Ink
程序集：  IAWinFX（在 IAWinFX.dll 中）

语法

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

instance.CopyTo(array, index)

public void CopyTo(
    ContextNode[] array,
    int index
)

public:
void CopyTo(
    array<ContextNode^>^ array, 
    int index
)

public void CopyTo(
    ContextNode[] array,
    int index
)

public function CopyTo(
    array : ContextNode[], 
    index : int
)

参数

  • array
    类型：array<System.Windows.Ink.ContextNode[]
    一维数组，用于接收从集合复制的元素。该数组必须具有从零开始的索引。
  • index
    类型：System.Int32
    array 参数中从零开始的索引，将从该索引处开始复制。

备注

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

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

  • array 参数为 nullnull 引用（在 Visual Basic 中为 Nothing） 引用。

  • index 参数小于零。

  • array 参数是多维的。

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

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

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

示例

下面的示例使用名为 theInkAnalyzer 的 InkAnalyzer 能够找到的段落填充 ContextNode 对象数组的一部分。数组从目标数组 paragraphArray 的索引 1（从零开始的数组中的第二个元素）开始，将目标数组的第一个元素（索引为 0）留空。

Dim paragraphs As ContextNodeCollection = theInkAnalyzer.FindNodesOfType(ContextNodeType.Paragraph)
Dim paragraphArray(paragraphs.Count + 1) As ContextNode
paragraphs.CopyTo(paragraphArray, 1)

ContextNodeCollection paragraphs =
    theInkAnalyzer.FindNodesOfType(ContextNodeType.Paragraph);
ContextNode[] paragraphArray = new ContextNode[paragraphs.Count + 1];
paragraphs.CopyTo(paragraphArray, 1);

平台

Windows Vista

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

版本信息

.NET Framework

受以下版本支持：3.0

另请参见

参考

ContextNodeCollection 类

ContextNodeCollection 成员

System.Windows.Ink 命名空间