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

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

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

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

指定した配列インデックスを開始位置として、配列に ICollection の要素をコピーします。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As Dictionary(Of
 TKey, TValue)
Dim array As Array
Dim index As Integer

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

C#

void ICollection.CopyTo (
    Array array,
    int index
)

C++

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

J#

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

JScript

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

パラメータ

array

ICollection から要素がコピーされる 1 次元の配列。配列では 0 から始まるインデックスを使用する必要があります。

index

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

例外

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

解説

Dictionary からコピーされる各要素は、値とそのキーを表す KeyValuePair 構造体です。

メモ
コピー元の 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

参照

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