Collection.CopyTo メソッド

.NET Framework クラス ライブラリ リファレンス

Collection.CopyTo メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

Collection 全体を互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。

名前空間: System.Collections.ObjectModel
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub CopyTo ( _
    array As T(), _
    index As Integer _
)

Visual Basic (使用法)

Dim instance As Collection(Of
 T)
Dim array As T()
Dim index As Integer

instance.CopyTo(array, index)

C#

public void CopyTo (
    T[] array,
    int index
)

C++

public:
virtual void CopyTo (
    array<T>^ array, 
    int index
) sealed

J#

public final void CopyTo (
    T[] array, 
    int index
)

JScript

public final function CopyTo (
    array : T[], 
    index : int
)

パラメータ

array

Collection から要素がコピーされる 1 次元の Array。Array には、0 から始まるインデックス番号が必要です。

index

コピーの開始位置となる、array の 0 から始まるインデックス番号。

例外

例外の種類	条件
ArgumentNullException	array が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	index が 0 未満です。
ArgumentException	index が array の長さ以上です。 または コピー元の Collection の要素数が、index からコピー先の array の末尾までに格納できる数を超えています。

解説

このメソッドは、System.Array.Copy を使用して要素をコピーします。

要素は、列挙子が Collection を反復処理するのと同じ順序で、Array にコピーされます。

このメソッドは O(n) 操作です。ここで、n は Count です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Collection ジェネリック クラス
Collection メンバ
System.Collections.ObjectModel 名前空間