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