List.System.Collections.ICollection.CopyTo メソッド

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

List.System.Collections.ICollection.CopyTo メソッド

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

ICollection の要素を Array にコピーします。Array の特定のインデックスからコピーが開始されます。

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

Visual Basic (宣言)

Private Sub System.Collections.ICollection.CopyTo
 ( _
    array As Array, _
    arrayIndex As Integer _
) Implements ICollection.CopyTo

Visual Basic (使用法)

Dim instance As List(Of
 T)
Dim array As Array
Dim arrayIndex As Integer

CType(instance, ICollection).CopyTo(array, arrayIndex)

C#

void ICollection.CopyTo (
    Array array,
    int arrayIndex
)

C++

private:
virtual void System.Collections.ICollection.CopyTo (
    Array^ array, 
    int arrayIndex
) sealed = ICollection::CopyTo

J#

J# では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

JScript

JScript では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

パラメータ

array

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

arrayIndex

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

例外

例外の種類	条件
ArgumentNullException	array が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	arrayIndex が 0 未満です。
ArgumentException	array が多次元です。 または array に 0 から始まるインデックス番号がありません。 または arrayIndex が array の長さ以上です。 または コピー元の ICollection の要素数が、arrayIndex からコピー先の array の末尾までに格納できる数を超えています。 または コピー元の ICollection の型が、コピー先の array の型に自動的にキャストできません。

解説

メモ
コピー元の ICollection の型をコピー先の array の型に自動的にキャストできない場合、ICollection.CopyTo の非汎用実装は InvalidCastException をスローします。汎用実装は ArgumentException をスローします。

このメソッドは 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

参照

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