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 參數中以零起始的索引，複製作業會從這裡開始。

備註

元素會以列舉值逐一查看 ContextNodeCollection 的相同順序複製到 Array 物件。

在下列情況下，會擲回例外狀況：

• array 參數為 nullNull 參照 (即 Visual Basic 中的 Nothing) 參考。

• index 參數小於零。

• array 參數為多維。

• index 參數等於或大於 array 參數的長度。

• 集合中元素的數目大於從 index 參數至目的 array 參數結尾的可用空間。

集合的型別會自動轉型 (Cast) 為目的 array 參數的型別。不過，這個方法只會將元素複製到與集合元素相同型別的陣列或 Object 型別的陣列。嘗試複製到另一個陣列型別會造成擲回 InvalidCastException 例外狀況。

範例

下列範例會將 InkAnalyzer (名為 theInkAnalyzer) 可以找到的段落，填入 ContextNode 物件陣列的一部分。從 paragraphArray 目的陣列的索引 1 (以零起始陣列中的第二個元素) 開始，並讓目的陣列的第一個元素 (索引為零) 保留空白。

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 命名空間