LinkedList.CopyTo メソッド

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

LinkedList.CopyTo メソッド

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As LinkedList(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

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

index

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

例外

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

解説

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

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

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

使用例

CopyTo メソッドのコード例および出力を次に示します。このコード例では、リンク リストと同じサイズの配列を作成し、CopyTo メソッドを使用してすべてのノードの値を配列の要素 0 で始まる文字列配列にコピーします。次に配列をクリアします。

このコード例および出力は、LinkedList クラスのトピックで取り上げている例の一部分です。

Visual Basic

        ' Create an array, specifying a size one less than the size
        ' of the linked list, because Visual Basic allocates one 
        ' more element than you specify.
        Console.WriteLine(vbLf & "Copy the list to an array.")
        Dim sArray(sentence.Count - 1) As String
 
        sentence.CopyTo(sArray, 0)

        For Each s As String
 In sArray
            Console.WriteLine(s)
        Next

        ' Release all the nodes.
        sentence.Clear()
<br /><span space="preserve">...</span><br
 />'Copy the list to an array.
'the
'quick
'brown
'dog
'jumped
'over
'the
'lazy
'rhinoceros

C#

        // Create an array with the same number of elements as the
        // linked list.
        Console.WriteLine("\nCopy the list to an array.");
        string[] sArray = new string[sentence.Count];
        sentence.CopyTo(sArray, 0);

        foreach( string s in
 sArray )
        {
            Console.WriteLine(s);
        }

        // Release all the nodes.
        sentence.Clear();
<br /><span space="preserve">...</span><br />//Copy
 the list to an array.
//the
//quick
//brown
//dog
//jumped
//over
//the
//lazy
//rhinoceros

C++

    // Create an array with the same number of elements as the
    // linked list.
    Console::WriteLine("\nCopy the list to an array.");
    array<String^>^ sArray = gcnew array<String^>(sentence->Count);
    sentence->CopyTo(sArray, 0);

    for each( String^ s in sArray )
    {
        Console::WriteLine(s);
    }

    // Release all the nodes.
    sentence->Clear();
<br /><span space="preserve">...</span><br />//Copy
 the list to an array.
//the
//quick
//brown
//dog
//jumped
//over
//the
//lazy
//rhinoceros

プラットフォーム

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

参照

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