CustomStrokes.CopyTo 方法
將目前 CustomStrokes 集合的所有元素都複製到指定的一維陣列，從指定的目的陣列索引開始。
命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)
語法
'宣告
Public Sub CopyTo ( _
array As Array, _
index As Integer _
)
'用途
Dim instance As CustomStrokes
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
array 參數中以零起始的索引，位於複製開始的位置。
實作
ICollection.CopyTo(Array, Int32)
備註
元素會以列舉值逐一查看 CustomStrokes 的相同順序複製到 System.Array (英文) 物件。
如果發生下列情況，會擲回例外狀況：
array 參數為 nullNull 參照 (即 Visual Basic 中的 Nothing) (在 Microsoft® Visual Basic® .NET 中為 Nothing) 參考。
index 參數小於零。
array 參數為多維。
index 參數等於或大於 array 參數的長度。
集合中元素的數目高於從 index 參數至目的 array 參數結尾的可用空間。
集合的型別會自動轉型 (Cast) 為目的 array 參數的型別。不過，這個方法只會將元素複製到與集合元素相同型別的陣列或 System.Object (英文) 型別的陣列。嘗試複製到另一個陣列型別會造成擲回 System.InvalidCastException (英文) 例外狀況。
這個方法不會同步處理。
範例
這個 C# 範例會將 Ink.CustomStrokes 集合的整個內容填入 Strokes 物件陣列的一部分。它會從 theCopies 目的陣列的元素 1 (以零起始陣列中的第二個元素) 開始，並讓目的陣列 (索引以零起始) 的第一個元素保留空白。
Strokes[] theCopies = new Strokes[theInkCollector.Ink.CustomStrokes.Count + 1];
theInkCollector.Ink.CustomStrokes.CopyTo(theCopies, 1);
這個 Visual Basic .NET 範例會將 Ink.CustomStrokes 集合的整個內容填入 Strokes 物件陣列的一部分。它會從 theCopies 目的陣列的元素 1 (以零起始陣列中的第二個元素) 開始，並讓目的陣列 (索引以零起始) 的第一個元素保留空白。
Dim theCopies(theInkCollector.Ink.CustomStrokes.Count) As Strokes
theInkCollector.Ink.CustomStrokes.CopyTo(theCopies, 1)
平台
Windows Vista
.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。
版本資訊
.NET Framework
支援版本：3.0