SortedList.CopyTo メソッド

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

SortedList.CopyTo メソッド

1 次元の Array インスタンスの指定したインデックスに SortedList の要素をコピーします。

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

Visual Basic (宣言)

Public Overridable Sub CopyTo
 ( _
    array As Array, _
    arrayIndex As Integer _
)

Visual Basic (使用法)

Dim instance As SortedList
Dim array As Array
Dim arrayIndex As Integer

instance.CopyTo(array, arrayIndex)

C#

public virtual void CopyTo (
    Array array,
    int arrayIndex
)

C++

public:
virtual void CopyTo (
    Array^ array, 
    int arrayIndex
)

J#

public void CopyTo (
    Array array, 
    int arrayIndex
)

JScript

public function CopyTo (
    array : Array, 
    arrayIndex : int
)

パラメータ

array

SortedList から DictionaryEntry オブジェクトがコピーされる 1 次元の Array。Array には、0 から始まるインデックス番号が必要です。

arrayIndex

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

例外

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

解説

キー/値ペアは、列挙子が SortedList を反復処理するのと同じ順序で、Array にコピーされます。

SortedList 内のキーだけをコピーするには、SortedList.Keys.CopyTo を使用します。

SortedList 内の値だけをコピーするには、SortedList.Values.CopyTo を使用します。

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

使用例

SortedList 内の値を 1 次元の Array にコピーする方法の例を次に示します。

Visual Basic

Imports System
Imports System.Collections

Public Class SamplesSortedList

   Public Shared Sub Main()

      ' Creates and initializes the source SortedList.
      Dim mySourceList As New
 SortedList()
      mySourceList.Add(2, "cats")
      mySourceList.Add(3, "in")
      mySourceList.Add(1, "napping")
      mySourceList.Add(4, "the")
      mySourceList.Add(0, "three")
      mySourceList.Add(5, "barn")

      ' Creates and initializes the one-dimensional target Array.
      Dim tempArray() As String
 = {"The", "quick",
 "brown", "fox", "jumped", "over", "the",
 "lazy", "dog"}
      Dim myTargetArray(14) As DictionaryEntry
      Dim i As Integer =
 0
      Dim s As String
      For Each s In  tempArray
         myTargetArray(i).Key = i
         myTargetArray(i).Value = s
         i += 1
      Next s

      ' Displays the values of the target Array.
      Console.WriteLine("The target Array contains the following
 (before and after copying):")
      PrintValues(myTargetArray, " "c)

      ' Copies the entire source SortedList to the target SortedList,
 starting at index 6.
      mySourceList.CopyTo(myTargetArray, 6)

      ' Displays the values of the target Array.
      PrintValues(myTargetArray, " "c)

   End Sub 'Main


   Public Shared Sub PrintValues(myArr()
 As DictionaryEntry, mySeparator As Char)
      Dim i As Integer
      For i = 0 To myArr.Length - 1
         Console.Write("{0}{1}", mySeparator, myArr(i).Value)
      Next i
      Console.WriteLine()
  End Sub 'PrintValues

End Class 'SamplesSortedList 


'This code produces the following output.
' 
'The target Array contains the following (before and after copying):
' The quick brown fox jumped over the lazy dog      
' The quick brown fox jumped over three napping cats in the barn

C#

 using System;
 using System.Collections;
 public class SamplesSortedList  {
 
    public static void Main()
  {
 
       // Creates and initializes the source SortedList.
       SortedList mySourceList = new SortedList();
       mySourceList.Add( 2, "cats" );
       mySourceList.Add( 3, "in" );
       mySourceList.Add( 1, "napping" );
       mySourceList.Add( 4, "the" );
       mySourceList.Add( 0, "three" );
       mySourceList.Add( 5, "barn" );
 
       // Creates and initializes the one-dimensional target Array.
       String[] tempArray = new String[] { "The", "quick",
 "brown", "fox", "jumped", "over", "the",
 "lazy", "dog" };
       DictionaryEntry[] myTargetArray = new DictionaryEntry[15];
       int i = 0;
       foreach ( String s in tempArray )  {
          myTargetArray[i].Key = i;
          myTargetArray[i].Value = s;
          i++;
       }

       // Displays the values of the target Array.
       Console.WriteLine( "The target Array contains the following (before and
 after copying):" );
       PrintValues( myTargetArray, ' ' );
 
       // Copies the entire source SortedList to the target SortedList,
 starting at index 6.
       mySourceList.CopyTo( myTargetArray, 6 );
 
       // Displays the values of the target Array.
       PrintValues( myTargetArray, ' ' );
    }
 
    public static void PrintValues(
 DictionaryEntry[] myArr, char mySeparator )  {
       for ( int i = 0; i < myArr.Length;
 i++ )
          Console.Write( "{0}{1}", mySeparator, myArr[i].Value );
       Console.WriteLine();
    }

 }


/*
This code produces the following output.
 
The target Array contains the following (before and after copying):
 The quick brown fox jumped over the lazy dog      
 The quick brown fox jumped over three napping cats in the barn

*/ 

C++

using namespace System;
using namespace System::Collections;
void PrintValues( array<DictionaryEntry>^ myArr, Char mySeparator
 );
int main()
{
   
   // Creates and initializes the source SortedList.
   SortedList^ mySourceList = gcnew SortedList;
   mySourceList->Add( 2, "cats" );
   mySourceList->Add( 3, "in" );
   mySourceList->Add( 1, "napping" );
   mySourceList->Add( 4, "the" );
   mySourceList->Add( 0, "three" );
   mySourceList->Add( 5, "barn" );
   
   // Creates and initializes the one-dimensional target Array.
   array<String^>^tempArray = {"The","quick","brown"
,"fox","jumped","over","the","lazy"
,"dog"};
   array<DictionaryEntry>^myTargetArray = gcnew array<DictionaryEntry>(15);
   int i = 0;
   IEnumerator^ myEnum = tempArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      String^ s = safe_cast<String^>(myEnum->Current);
      myTargetArray[ i ].Key = i;
      myTargetArray[ i ].Value = s;
      i++;
   }

   
   // Displays the values of the target Array.
   Console::WriteLine( "The target Array contains the following (before and
 after copying):" );
   PrintValues( myTargetArray, ' ' );
   
   // Copies the entire source SortedList to the target SortedList,
 starting at index 6.
   mySourceList->CopyTo( myTargetArray, 6 );
   
   // Displays the values of the target Array.
   PrintValues( myTargetArray, ' ' );
}

void PrintValues( array<DictionaryEntry>^ myArr, Char mySeparator
 )
{
   for ( int i = 0; i < myArr->Length;
 i++ )
      Console::Write( "{0}{1}", mySeparator, myArr[ i ].Value );
   Console::WriteLine();
}

/*
This code produces the following output.
 
The target Array contains the following (before and after copying):
 The quick brown fox jumped over the lazy dog      
 The quick brown fox jumped over three napping cats in the barn

*/

J#

import System.*;
import System.Collections.*;

public class SamplesSortedList
{

    public static void main(String[]
 args)
    {
        // Creates and initializes the source SortedList.
        SortedList mySourceList = new SortedList();

        mySourceList.Add((Int32)2, "cats");
        mySourceList.Add((Int32)3, "in");
        mySourceList.Add((Int32)1, "napping");
        mySourceList.Add((Int32)4, "the");
        mySourceList.Add((Int32)0, "three");
        mySourceList.Add((Int32)5, "barn");

        // Creates and initializes the one-dimensional target Array.
        String tempArray[] = new String[] {"The", "quick",
 "brown", "fox", 
            "jumped", "over", "the", "lazy",
 "dog"};
        DictionaryEntry myTargetArray[] = new DictionaryEntry[15];

        for (int iCtr = 0; iCtr < tempArray.length;
 iCtr++) {
            String s = tempArray[iCtr];
            myTargetArray[iCtr].set_Key((Int32)iCtr);
            myTargetArray[iCtr].set_Value(s);
        }

        // Displays the values of the target Array.
        Console.WriteLine("The target Array contains the following " 
            + "(before and after copying):");
        PrintValues(myTargetArray, ' ');

        // Copies the entire source SortedList to the target SortedList,
 
        // starting at index 6.
        mySourceList.CopyTo(myTargetArray, 6);

        // Displays the values of the target Array.
        PrintValues(myTargetArray, ' ');
    } //main

    public static void PrintValues(DictionaryEntry[]
 myArr, char mySeparator)
    {
        for (int i = 0; i < myArr.length;
 i++) {
            Console.Write("{0}{1}", 
                System.Convert.ToString(mySeparator), 
                System.Convert.ToString(myArr[i].get_Value()));
        }
        Console.WriteLine();
    } //PrintValues
} //SamplesSortedList

/*
This code produces the following output.
 
The target Array contains the following (before and after copying):
 The quick brown fox jumped over the lazy dog      
 The quick brown fox jumped over three napping cats in the barn

 */

プラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SortedList クラス
SortedList メンバ
System.Collections 名前空間
Array クラス
DictionaryEntry 構造体
GetEnumerator