ContextNodeCollection.CopyTo 方法

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

命名空间:  Microsoft.Ink
程序集:  Microsoft.Ink.Analysis(在 Microsoft.Ink.Analysis.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<Microsoft.Ink.ContextNode[]
    用作要将集合中的元素复制到的目标的一维数组。该数组必须具有从零开始的索引。
  • index
    类型:System.Int32
    array 参数中从零开始的索引,将从该索引处开始复制。

备注

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

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

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

  • index 参数小于零。

  • array 参数是多维的。

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

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

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

此方法是同步的。

示例

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

Dim paragraphs As ContextNodeCollection = _
    theInkAnalyzer.FindNodesOfType(Microsoft.Ink.ContextNodeType.Paragraph)
Dim paragraphArray(paragraphs.Count) As ContextNode
paragraphs.CopyTo(paragraphArray, 1)
            ContextNodeCollection paragraphs =
                theInkAnalyzer.FindNodesOfType(Microsoft.Ink.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 成员

Microsoft.Ink 命名空间