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