NameObjectCollectionBase.ICollection.CopyTo(Array, Int32) 方法

定義

從目標陣列的指定索引開始,將整個 NameObjectCollectionBase 複製到相容的一維 ArrayCopies the entire NameObjectCollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array.

 virtual void System.Collections.ICollection.CopyTo(Array ^ array, int index) = System::Collections::ICollection::CopyTo;
void ICollection.CopyTo (Array array, int index);

參數

array
Array

一維 Array,是從 NameObjectCollectionBase 複製過來之項目的目的端。The one-dimensional Array that is the destination of the elements copied from NameObjectCollectionBase. Array 必須有以零為起始的索引。The Array must have zero-based indexing.

index
Int32

array 中以零起始的索引,即開始複製的位置。The zero-based index in array at which copying begins.

實作

例外狀況

arraynullarray is null.

index 小於零。index is less than zero.

array 是多維的。array is multidimensional.

-或--or- 來源 NameObjectCollectionBase 中的項目數大於 index 到目的 array 結尾的可用空間。The number of elements in the source NameObjectCollectionBase is greater than the available space from index to the end of the destination array.

來源 NameObjectCollectionBase 的類型無法自動轉換成目的 array 的類型。The type of the source NameObjectCollectionBase cannot be cast automatically to the type of the destination array.

備註

指定的陣列必須是相容的類型。The specified array must be of a compatible type.

這個方法會Array.Copy使用來複製元素。This method uses Array.Copy to copy the elements.

雖然 com ICollection.CopyTo用戶端預設不會看到該方法,但NameObjectCollectionBase繼承類別可以公開它,而且可能會在 com 用戶端中造成不必要的行為。While the ICollection.CopyTo method is not visible to COM clients by default, inheriting the NameObjectCollectionBase class can expose it and can cause undesirable behavior in COM clients.

這個方法是 O (n)運算,其中nCountThis method is an O(n) operation, where n is Count.

適用於