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

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

從目標陣列的指定索引開始，將整個 NameObjectCollectionBase 複製到相容的一維 Array。

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

void ICollection.CopyTo (Array array, int index);

void ICollection.CopyTo (Array? array, int index);

abstract member System.Collections.ICollection.CopyTo : Array * int -> unit
override this.System.Collections.ICollection.CopyTo : Array * int -> unit

Sub CopyTo (array As Array, index As Integer) Implements ICollection.CopyTo

一維 Array，是從 NameObjectCollectionBase 複製過來之項目的目的端。 Array 必須有以零為起始的索引。

array 中以零起始的索引，即開始複製的位置。

CopyTo(Array, Int32)

array 為 null。

index 小於零。

array 是多維的。

-或-

來源 NameObjectCollectionBase 中的項目數大於 index 到目的 array 結尾的可用空間。

來源 NameObjectCollectionBase 的類型無法自動轉換成目的 array 的類型。

指定的陣列必須是相容的類型。

這個方法會使用 Array.Copy 來複製專案。

ICollection.CopyTo雖然 COM 用戶端預設看不到方法，但繼承 NameObjectCollectionBase 類別可能會公開它，而且可能會導致 COM 用戶端中不想要的行為。

這個方法是 O (n) 作業，其中 n 是 Count。

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0