Array.Copy メソッド

定義

一方の Array の要素範囲を他方の Array にコピーし、必要に応じて型キャストとボックス化を実行します。Copies a range of elements in one Array to another Array and performs type casting and boxing as required.

オーバーロード

Copy(Array, Int64, Array, Int64, Int64)

指定したコピー元インデックスを開始位置として Array から要素の範囲をコピーし、指定したコピー先インデックスを開始位置として他の Array にそれらの要素を貼り付けます。Copies a range of elements from an Array starting at the specified source index and pastes them to another Array starting at the specified destination index. 長さとインデックスは、64 ビット整数として指定します。The length and the indexes are specified as 64-bit integers.

Copy(Array, Int32, Array, Int32, Int32)

指定したコピー元インデックスを開始位置として Array から要素の範囲をコピーし、指定したコピー先インデックスを開始位置として他の Array にそれらの要素を貼り付けます。Copies a range of elements from an Array starting at the specified source index and pastes them to another Array starting at the specified destination index. 長さとインデックスは、32 ビット整数として指定します。The length and the indexes are specified as 32-bit integers.

Copy(Array, Array, Int64)

最初の要素を開始位置として Array から要素の範囲をコピーし、最初の要素を開始位置として他の Array にそれらの要素を貼り付けます。Copies a range of elements from an Array starting at the first element and pastes them into another Array starting at the first element. 長さは 64 ビット整数値として指定します。The length is specified as a 64-bit integer.

Copy(Array, Array, Int32)

最初の要素を開始位置として Array から要素の範囲をコピーし、最初の要素を開始位置として他の Array にそれらの要素を貼り付けます。Copies a range of elements from an Array starting at the first element and pastes them into another Array starting at the first element. 長さは 32 ビット整数値として指定します。The length is specified as a 32-bit integer.

Copy(Array, Int64, Array, Int64, Int64)

指定したコピー元インデックスを開始位置として Array から要素の範囲をコピーし、指定したコピー先インデックスを開始位置として他の Array にそれらの要素を貼り付けます。Copies a range of elements from an Array starting at the specified source index and pastes them to another Array starting at the specified destination index. 長さとインデックスは、64 ビット整数として指定します。The length and the indexes are specified as 64-bit integers.

public:
 static void Copy(Array ^ sourceArray, long sourceIndex, Array ^ destinationArray, long destinationIndex, long length);
public static void Copy (Array sourceArray, long sourceIndex, Array destinationArray, long destinationIndex, long length);
static member Copy : Array * int64 * Array * int64 * int64 -> unit
Public Shared Sub Copy (sourceArray As Array, sourceIndex As Long, destinationArray As Array, destinationIndex As Long, length As Long)

パラメーター

sourceArray
Array

コピーするデータを格納している ArrayThe Array that contains the data to copy.

sourceIndex
Int64

コピー操作の開始位置となる sourceArray 内のインデックスを表す 64 ビット整数。A 64-bit integer that represents the index in the sourceArray at which copying begins.

destinationArray
Array

データを受け取る ArrayThe Array that receives the data.

destinationIndex
Int64

格納を開始する destinationArray のインデックスを表す 64 ビット整数。A 64-bit integer that represents the index in the destinationArray at which storing begins.

length
Int64

コピーする要素の数を表す 64 ビット整数。A 64-bit integer that represents the number of elements to copy. この整数は 0 から MaxValue (この値を含む) の間である必要があります。The integer must be between zero and MaxValue, inclusive.

例外

sourceArraynull です。sourceArray is null.

- または --or- destinationArraynull です。destinationArray is null.

sourceArraydestinationArray のランクが異なります。sourceArray and destinationArray have different ranks.

sourceArraydestinationArray の型は互換性がありません。sourceArray and destinationArray are of incompatible types.

sourceArray の少なくとも 1 つの要素が destinationArray の型にキャストできません。At least one element in sourceArray cannot be cast to the type of destinationArray.

sourceIndexsourceArray の有効なインデックスの範囲外です。sourceIndex is outside the range of valid indexes for the sourceArray.

- または --or- destinationIndexdestinationArrayの有効なインデックスの範囲外です。destinationIndex is outside the range of valid indexes for the destinationArray.

- または --or- length が 0 未満であるか、または MaxValueを超えています。length is less than 0 or greater than MaxValue.

lengthsourceIndex から最後の sourceArrayまでの要素の数を超えています。length is greater than the number of elements from sourceIndex to the end of sourceArray.

- または --or- lengthdestinationIndex から最後の destinationArray までの要素の数を超えています。length is greater than the number of elements from destinationIndex to the end of destinationArray.

次のコード例は、Object 型の1つの Array から integer 型の別の Array にコピーする方法を示しています。The following code example shows how to copy from one Array of type Object to another Array of type integer.

using namespace System;
void PrintValues( Array^ myArr );
void main()
{
   
   // Creates and initializes a new Array instance of type Int32.
   Array^ myIntArray = Array::CreateInstance( Type::GetType(  "System.Int32" ), 5 );
   for ( int i = myIntArray->GetLowerBound( 0 ); i <= myIntArray->GetUpperBound( 0 ); i++ )
      myIntArray->SetValue( i + 1, i );
   
   // Creates and initializes a new Array instance of type Object.
   Array^ myObjArray = Array::CreateInstance( Type::GetType(  "System.Object" ), 5 );
   for ( int i = myObjArray->GetLowerBound( 0 ); i <= myObjArray->GetUpperBound( 0 ); i++ )
      myObjArray->SetValue( i + 26, i );
   
   // Displays the initial values of both arrays.
   Console::WriteLine(  "Int32 array:" );
   PrintValues( myIntArray );
   Console::WriteLine(  "Object array:" );
   PrintValues( myObjArray );
   
   // Copies the first element from the Int32 array to the Object array.
   Array::Copy( myIntArray, myIntArray->GetLowerBound( 0 ), myObjArray, myObjArray->GetLowerBound( 0 ), 1 );
   
   // Copies the last two elements from the Object array to the Int32 array.
   Array::Copy( myObjArray, myObjArray->GetUpperBound( 0 ) - 1, myIntArray, myIntArray->GetUpperBound( 0 ) - 1, 2 );
   
   // Displays the values of the modified arrays.
   Console::WriteLine(  "Int32 array - Last two elements should now be the same as Object array:" );
   PrintValues( myIntArray );
   Console::WriteLine(  "Object array - First element should now be the same as Int32 array:" );
   PrintValues( myObjArray );
}

void PrintValues( Array^ myArr )
{
   System::Collections::IEnumerator^ myEnumerator = myArr->GetEnumerator();
   int i = 0;
   int cols = myArr->GetLength( myArr->Rank - 1 );
   while ( myEnumerator->MoveNext() )
   {
      if ( i < cols )
      {
         i++;
      }
      else
      {
         Console::WriteLine();
         i = 1;
      }

      Console::Write(  "\t{0}", myEnumerator->Current );
   }

   Console::WriteLine();
}

/*
 This code produces the following output.
 
 Int32 array:
     1    2    3    4    5
 Object array:
     26    27    28    29    30
 Int32 array - Last two elements should now be the same as Object array:
     1    2    3    29    30
 Object array - First element should now be the same as Int32 array:
     1    27    28    29    30
 */
using System;
public class SamplesArray  {

   public static void Main()  {

      // Creates and initializes a new Array of type Int32.
      Array myIntArray=Array.CreateInstance( typeof(System.Int32), 5 );
      for ( int i = myIntArray.GetLowerBound(0); i <= myIntArray.GetUpperBound(0); i++ )
         myIntArray.SetValue( i+1, i );

      // Creates and initializes a new Array of type Object.
      Array myObjArray = Array.CreateInstance( typeof(System.Object), 5 );
      for ( int i = myObjArray.GetLowerBound(0); i <= myObjArray.GetUpperBound(0); i++ )
         myObjArray.SetValue( i+26, i );

      // Displays the initial values of both arrays.
      Console.WriteLine( "Int32 array:" );
      PrintValues( myIntArray );
      Console.WriteLine( "Object array:" );
      PrintValues( myObjArray );

      // Copies the first element from the Int32 array to the Object array.
      Array.Copy( myIntArray, myIntArray.GetLowerBound(0), myObjArray, myObjArray.GetLowerBound(0), 1 );

      // Copies the last two elements from the Object array to the Int32 array.
      Array.Copy( myObjArray, myObjArray.GetUpperBound(0) - 1, myIntArray, myIntArray.GetUpperBound(0) - 1, 2 );

      // Displays the values of the modified arrays.
      Console.WriteLine( "Int32 array - Last two elements should now be the same as Object array:" );
      PrintValues( myIntArray );
      Console.WriteLine( "Object array - First element should now be the same as Int32 array:" );
      PrintValues( myObjArray );
   }


   public static void PrintValues( Array myArr )  {
      System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
      int i = 0;
      int cols = myArr.GetLength( myArr.Rank - 1 );
      while ( myEnumerator.MoveNext() )  {
         if ( i < cols )  {
            i++;
         } else  {
            Console.WriteLine();
            i = 1;
         }
         Console.Write( "\t{0}", myEnumerator.Current );
      }
      Console.WriteLine();
   }
}
/*
This code produces the following output.

Int32 array:
    1    2    3    4    5
Object array:
    26    27    28    29    30
Int32 array - Last two elements should now be the same as Object array:
    1    2    3    29    30
Object array - First element should now be the same as Int32 array:
    1    27    28    29    30
*/
Public Class SamplesArray    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new Array of type Int32.
        Dim myIntArray As Array = _
           Array.CreateInstance(GetType(System.Int32), 5)
        Dim i As Integer
        For i = myIntArray.GetLowerBound(0) To myIntArray.GetUpperBound(0)
            myIntArray.SetValue(i + 1, i)
        Next i 
        ' Creates and initializes a new Array of type Object.
        Dim myObjArray As Array = _
           Array.CreateInstance(GetType(System.Object), 5)
        For i = myObjArray.GetLowerBound(0) To myObjArray.GetUpperBound(0)
            myObjArray.SetValue(i + 26, i)
        Next i 
        ' Displays the initial values of both arrays.
        Console.WriteLine("Int32 array:")
        PrintValues(myIntArray)
        Console.WriteLine("Object array:")
        PrintValues(myObjArray)
        
        ' Copies the first element from the Int32 array to the Object array.
        Array.Copy(myIntArray, myIntArray.GetLowerBound(0), myObjArray, _
           myObjArray.GetLowerBound(0), 1)
        
        ' Copies the last two elements from the Object array to the Int32 array.
        Array.Copy(myObjArray, myObjArray.GetUpperBound(0) - 1, myIntArray, _
           myIntArray.GetUpperBound(0) - 1, 2)
        
        ' Displays the values of the modified arrays.
        Console.WriteLine("Int32 array - Last two elements should now be " _
           + "the same as Object array:")
        PrintValues(myIntArray)
        Console.WriteLine("Object array - First element should now be the " _
           + "same as Int32 array:")
        PrintValues(myObjArray)
    End Sub
    
    Public Shared Sub PrintValues(myArr As Array)
        Dim myEnumerator As System.Collections.IEnumerator = _
           myArr.GetEnumerator()
        Dim i As Integer = 0
        Dim cols As Integer = myArr.GetLength((myArr.Rank - 1))
        While myEnumerator.MoveNext()
            If i < cols Then
                i += 1
            Else
                Console.WriteLine()
                i = 1
            End If
            Console.Write(ControlChars.Tab + "{0}", myEnumerator.Current)
        End While
        Console.WriteLine()
    End Sub
End Class

' This code produces the following output.
' 
' Int32 array:
'     1    2    3    4    5
' Object array:
'     26    27    28    29    30
' Int32 array - Last two elements should now be the same as Object array:
'     1    2    3    29    30
' Object array - First element should now be the same as Int32 array:
'     1    27    28    29    30

注釈

sourceArray パラメーターと destinationArray パラメーターの次元数は同じである必要があります。The sourceArray and destinationArray parameters must have the same number of dimensions. さらに、destinationArray は既に次元になっている必要があり、コピーされたデータを格納するために、destinationIndex の位置から十分な数の要素を持つ必要があります。In addition, destinationArray must already have been dimensioned and must have a sufficient number of elements starting from the destinationIndex position to accommodate the copied data.

多次元配列間でコピーを行う場合、配列は、行 (または列) が概念的にエンドツーエンドでレイアウトされる、長い1次元配列のように動作します。When copying between multidimensional arrays, the array behaves like a long one-dimensional array, where the rows (or columns) are conceptually laid end-to-end. たとえば、配列に4つの要素を持つ3つの行 (または列) がある場合、配列の先頭から6つの要素をコピーすると、最初の行 (または列) の4つの要素と2番目の行 (または列) の最初の2つの要素がコピーされます。For example, if an array has three rows (or columns) with four elements each, copying six elements from the beginning of the array would copy all four elements of the first row (or column) and the first two elements of the second row (or column). 3番目の行 (または列) の2番目の要素からコピーを開始するには、sourceIndex は最初の行 (または列) と2番目の行の長さ (または列) に2を加算した値である必要があります。To start copying from the second element of the third row (or column), sourceIndex must be the upper bound of the first row (or column) plus the length of the second row (or column) plus two.

sourceArraydestinationArray 重複する場合、このメソッドは destinationArray が上書きされる前に sourceArray の元の値が一時的な場所に保持されていたかのように動作します。If sourceArray and destinationArray overlap, this method behaves as if the original values of sourceArray were preserved in a temporary location before destinationArray is overwritten.

[C++][C++]

このメソッドは、memcpy ではC++なく、標準 C/関数 memmove と同じです。This method is equivalent to the standard C/C++ function memmove, not memcpy.

配列には、参照型の配列または値型の配列を指定できます。The arrays can be reference-type arrays or value-type arrays. 必要に応じて、型ダウンキャストが実行されます。Type downcasting is performed, as required.

  • 参照型の配列から値型の配列にコピーする場合、各要素のボックス化が解除されてからコピーされます。When copying from a reference-type array to a value-type array, each element is unboxed and then copied. 値型の配列から参照型の配列にコピーする場合、各要素はボックス化された後にコピーされます。When copying from a value-type array to a reference-type array, each element is boxed and then copied.

  • 参照型または値型の配列から Object 配列にコピーする場合、各値または参照を保持してコピーした後 Object が作成されます。When copying from a reference-type or value-type array to an Object array, an Object is created to hold each value or reference and then copied. Object 配列から参照型または値型の配列にコピーするときに、割り当てができない場合は、InvalidCastException がスローされます。When copying from an Object array to a reference-type or value-type array and the assignment is not possible, an InvalidCastException is thrown.

  • sourceArraydestinationArray の両方が参照型の配列であるか、両方とも Object型の配列である場合、簡易コピーが実行されます。If sourceArray and destinationArray are both reference-type arrays or are both arrays of type Object, a shallow copy is performed. Array の簡易コピーは、元の Arrayと同じ要素への参照を含む新しい Array です。A shallow copy of an Array is a new Array containing references to the same elements as the original Array. 要素自体、または要素によって参照されるものはコピーされません。The elements themselves or anything referenced by the elements are not copied. これに対し、Array の詳細コピーでは、要素と要素によって直接的または間接的に参照されるすべての要素がコピーされます。In contrast, a deep copy of an Array copies the elements and everything directly or indirectly referenced by the elements.

配列の型に互換性がない場合は、ArrayTypeMismatchException がスローされます。An ArrayTypeMismatchException is thrown if the arrays are of incompatible types. 型の互換性は次のように定義されます。Type compatibility is defined as follows:

  • 型は、それ自体と互換性があります。A type is compatible with itself.

  • 値型は、Object およびその値型によって実装されたインターフェイス型と互換性があります。A value type is compatible with Object and with an interface type implemented by that value type. 値型は、インターフェイスを直接実装する場合にのみ、インターフェイスに接続されていると見なされます。A value type is considered connected to an interface only if it implements that interface directly. 切断された型には互換性がありません。Disconnected types are not compatible.

  • ソース型から変換先の型へのコピーが拡大変換である場合、2つの組み込み (定義済み) 値型には互換性があります。Two intrinsic (predefined) value types are compatible if copying from the source type to the destination type is a widening conversion. 拡大変換によって情報が失われることはありませんが、縮小変換によって情報が失われる可能性があります。A widening conversion never loses information, whereas a narrowing conversion can lose information. たとえば、32ビット符号付き整数から64ビット符号付き整数への変換は拡大変換であり、64ビット符号付き整数から32ビット符号付き整数への変換は縮小変換です。For example, converting a 32-bit signed integer to a 64-bit signed integer is a widening conversion, and converting a 64-bit signed integer to a 32-bit signed integer is a narrowing conversion. 変換の詳細については、「Convert」を参照してください。For more information about conversions, see Convert.

  • 非組み込み型 (ユーザー定義) の値型は、それ自体と互換性があるだけです。A nonintrinsic (user-defined) value type is compatible only with itself.

  • 列挙型には、Enum およびその基になる型への暗黙的な変換があります。Enumerations have an implicit conversion to Enum and to their underlying type.

sourceArray のすべての要素にダウンキャストが必要な場合 (たとえば、基本クラスから派生クラス、またはインターフェイスからオブジェクトへのキャスト)、1つ以上の要素を destinationArrayの対応する型にキャストできない場合は InvalidCastException がスローされます。If every element in sourceArray requires a downcast (for example, from a base class to a derived class or from an interface to an object) and one or more elements cannot be cast to the corresponding type in destinationArray, an InvalidCastException is thrown.

コピー中にこのメソッドが例外をスローした場合、destinationArray の状態は未定義になります。If this method throws an exception while copying, the state of destinationArray is undefined.

このメソッドは O(n) 操作です。nlength です。This method is an O(n) operation, where n is length.

こちらもご覧ください

Copy(Array, Int32, Array, Int32, Int32)

指定したコピー元インデックスを開始位置として Array から要素の範囲をコピーし、指定したコピー先インデックスを開始位置として他の Array にそれらの要素を貼り付けます。Copies a range of elements from an Array starting at the specified source index and pastes them to another Array starting at the specified destination index. 長さとインデックスは、32 ビット整数として指定します。The length and the indexes are specified as 32-bit integers.

public:
 static void Copy(Array ^ sourceArray, int sourceIndex, Array ^ destinationArray, int destinationIndex, int length);
public static void Copy (Array sourceArray, int sourceIndex, Array destinationArray, int destinationIndex, int length);
static member Copy : Array * int * Array * int * int -> unit
Public Shared Sub Copy (sourceArray As Array, sourceIndex As Integer, destinationArray As Array, destinationIndex As Integer, length As Integer)

パラメーター

sourceArray
Array

コピーするデータを格納している ArrayThe Array that contains the data to copy.

sourceIndex
Int32

コピー操作の開始位置となる sourceArray 内のインデックスを表す 32 ビット整数。A 32-bit integer that represents the index in the sourceArray at which copying begins.

destinationArray
Array

データを受け取る ArrayThe Array that receives the data.

destinationIndex
Int32

格納を開始する destinationArray のインデックスを表す 32 ビット整数。A 32-bit integer that represents the index in the destinationArray at which storing begins.

length
Int32

コピーする要素の数を表す 32 ビット整数。A 32-bit integer that represents the number of elements to copy.

例外

sourceArraynull です。sourceArray is null.

- または --or- destinationArraynull です。destinationArray is null.

sourceArraydestinationArray のランクが異なります。sourceArray and destinationArray have different ranks.

sourceArraydestinationArray の型は互換性がありません。sourceArray and destinationArray are of incompatible types.

sourceArray の少なくとも 1 つの要素が destinationArray の型にキャストできません。At least one element in sourceArray cannot be cast to the type of destinationArray.

sourceIndexsourceArray の最初の次元の下限を下回っています。sourceIndex is less than the lower bound of the first dimension of sourceArray.

- または --or- destinationIndexdestinationArray の最初の次元の下限を下回っています。destinationIndex is less than the lower bound of the first dimension of destinationArray.

- または --or- length が 0 未満です。length is less than zero.

lengthsourceIndex から最後の sourceArray までの要素の数を超えています。length is greater than the number of elements from sourceIndex to the end of sourceArray.

- または --or- lengthdestinationIndex から最後の destinationArray までの要素の数を超えています。length is greater than the number of elements from destinationIndex to the end of destinationArray.

次のコード例は、Object 型の1つの Array から integer 型の別の Array にコピーする方法を示しています。The following code example shows how to copy from one Array of type Object to another Array of type integer.

using namespace System;
void PrintValues( Array^ myArr );
void main()
{
   
   // Creates and initializes a new Array instance of type Int32.
   Array^ myIntArray = Array::CreateInstance( Type::GetType(  "System.Int32" ), 5 );
   for ( int i = myIntArray->GetLowerBound( 0 ); i <= myIntArray->GetUpperBound( 0 ); i++ )
      myIntArray->SetValue( i + 1, i );
   
   // Creates and initializes a new Array instance of type Object.
   Array^ myObjArray = Array::CreateInstance( Type::GetType(  "System.Object" ), 5 );
   for ( int i = myObjArray->GetLowerBound( 0 ); i <= myObjArray->GetUpperBound( 0 ); i++ )
      myObjArray->SetValue( i + 26, i );
   
   // Displays the initial values of both arrays.
   Console::WriteLine(  "Int32 array:" );
   PrintValues( myIntArray );
   Console::WriteLine(  "Object array:" );
   PrintValues( myObjArray );
   
   // Copies the first element from the Int32 array to the Object array.
   Array::Copy( myIntArray, myIntArray->GetLowerBound( 0 ), myObjArray, myObjArray->GetLowerBound( 0 ), 1 );
   
   // Copies the last two elements from the Object array to the Int32 array.
   Array::Copy( myObjArray, myObjArray->GetUpperBound( 0 ) - 1, myIntArray, myIntArray->GetUpperBound( 0 ) - 1, 2 );
   
   // Displays the values of the modified arrays.
   Console::WriteLine(  "Int32 array - Last two elements should now be the same as Object array:" );
   PrintValues( myIntArray );
   Console::WriteLine(  "Object array - First element should now be the same as Int32 array:" );
   PrintValues( myObjArray );
}

void PrintValues( Array^ myArr )
{
   System::Collections::IEnumerator^ myEnumerator = myArr->GetEnumerator();
   int i = 0;
   int cols = myArr->GetLength( myArr->Rank - 1 );
   while ( myEnumerator->MoveNext() )
   {
      if ( i < cols )
      {
         i++;
      }
      else
      {
         Console::WriteLine();
         i = 1;
      }

      Console::Write(  "\t{0}", myEnumerator->Current );
   }

   Console::WriteLine();
}

/*
 This code produces the following output.
 
 Int32 array:
     1    2    3    4    5
 Object array:
     26    27    28    29    30
 Int32 array - Last two elements should now be the same as Object array:
     1    2    3    29    30
 Object array - First element should now be the same as Int32 array:
     1    27    28    29    30
 */
using System;
public class SamplesArray  {

   public static void Main()  {

      // Creates and initializes a new Array of type Int32.
      Array myIntArray=Array.CreateInstance( typeof(System.Int32), 5 );
      for ( int i = myIntArray.GetLowerBound(0); i <= myIntArray.GetUpperBound(0); i++ )
         myIntArray.SetValue( i+1, i );

      // Creates and initializes a new Array of type Object.
      Array myObjArray = Array.CreateInstance( typeof(System.Object), 5 );
      for ( int i = myObjArray.GetLowerBound(0); i <= myObjArray.GetUpperBound(0); i++ )
         myObjArray.SetValue( i+26, i );

      // Displays the initial values of both arrays.
      Console.WriteLine( "Int32 array:" );
      PrintValues( myIntArray );
      Console.WriteLine( "Object array:" );
      PrintValues( myObjArray );

      // Copies the first element from the Int32 array to the Object array.
      Array.Copy( myIntArray, myIntArray.GetLowerBound(0), myObjArray, myObjArray.GetLowerBound(0), 1 );

      // Copies the last two elements from the Object array to the Int32 array.
      Array.Copy( myObjArray, myObjArray.GetUpperBound(0) - 1, myIntArray, myIntArray.GetUpperBound(0) - 1, 2 );

      // Displays the values of the modified arrays.
      Console.WriteLine( "Int32 array - Last two elements should now be the same as Object array:" );
      PrintValues( myIntArray );
      Console.WriteLine( "Object array - First element should now be the same as Int32 array:" );
      PrintValues( myObjArray );
   }


   public static void PrintValues( Array myArr )  {
      System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
      int i = 0;
      int cols = myArr.GetLength( myArr.Rank - 1 );
      while ( myEnumerator.MoveNext() )  {
         if ( i < cols )  {
            i++;
         } else  {
            Console.WriteLine();
            i = 1;
         }
         Console.Write( "\t{0}", myEnumerator.Current );
      }
      Console.WriteLine();
   }
}
/*
This code produces the following output.

Int32 array:
    1    2    3    4    5
Object array:
    26    27    28    29    30
Int32 array - Last two elements should now be the same as Object array:
    1    2    3    29    30
Object array - First element should now be the same as Int32 array:
    1    27    28    29    30
*/
Public Class SamplesArray    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new Array of type Int32.
        Dim myIntArray As Array = _
           Array.CreateInstance(GetType(System.Int32), 5)
        Dim i As Integer
        For i = myIntArray.GetLowerBound(0) To myIntArray.GetUpperBound(0)
            myIntArray.SetValue(i + 1, i)
        Next i 
        ' Creates and initializes a new Array of type Object.
        Dim myObjArray As Array = _
           Array.CreateInstance(GetType(System.Object), 5)
        For i = myObjArray.GetLowerBound(0) To myObjArray.GetUpperBound(0)
            myObjArray.SetValue(i + 26, i)
        Next i 
        ' Displays the initial values of both arrays.
        Console.WriteLine("Int32 array:")
        PrintValues(myIntArray)
        Console.WriteLine("Object array:")
        PrintValues(myObjArray)
        
        ' Copies the first element from the Int32 array to the Object array.
        Array.Copy(myIntArray, myIntArray.GetLowerBound(0), myObjArray, _
           myObjArray.GetLowerBound(0), 1)
        
        ' Copies the last two elements from the Object array to the Int32 array.
        Array.Copy(myObjArray, myObjArray.GetUpperBound(0) - 1, myIntArray, _
           myIntArray.GetUpperBound(0) - 1, 2)
        
        ' Displays the values of the modified arrays.
        Console.WriteLine("Int32 array - Last two elements should now be " _
           + "the same as Object array:")
        PrintValues(myIntArray)
        Console.WriteLine("Object array - First element should now be the " _
           + "same as Int32 array:")
        PrintValues(myObjArray)
    End Sub
    
    Public Shared Sub PrintValues(myArr As Array)
        Dim myEnumerator As System.Collections.IEnumerator = _
           myArr.GetEnumerator()
        Dim i As Integer = 0
        Dim cols As Integer = myArr.GetLength((myArr.Rank - 1))
        While myEnumerator.MoveNext()
            If i < cols Then
                i += 1
            Else
                Console.WriteLine()
                i = 1
            End If
            Console.Write(ControlChars.Tab + "{0}", myEnumerator.Current)
        End While
        Console.WriteLine()
    End Sub
End Class

' This code produces the following output.
' 
' Int32 array:
'     1    2    3    4    5
' Object array:
'     26    27    28    29    30
' Int32 array - Last two elements should now be the same as Object array:
'     1    2    3    29    30
' Object array - First element should now be the same as Int32 array:
'     1    27    28    29    30

注釈

sourceArray パラメーターと destinationArray パラメーターの次元数は同じである必要があります。The sourceArray and destinationArray parameters must have the same number of dimensions. さらに、destinationArray は既に次元になっている必要があり、コピーされたデータを格納するために、destinationIndex の位置から十分な数の要素を持つ必要があります。In addition, destinationArray must already have been dimensioned and must have a sufficient number of elements starting from the destinationIndex position to accommodate the copied data.

多次元配列間でコピーを行う場合、配列は、行 (または列) が概念的にエンドツーエンドでレイアウトされる、長い1次元配列のように動作します。When copying between multidimensional arrays, the array behaves like a long one-dimensional array, where the rows (or columns) are conceptually laid end-to-end. たとえば、配列に4つの要素を持つ3つの行 (または列) がある場合、配列の先頭から6つの要素をコピーすると、最初の行 (または列) の4つの要素と2番目の行 (または列) の最初の2つの要素がコピーされます。For example, if an array has three rows (or columns) with four elements each, copying six elements from the beginning of the array would copy all four elements of the first row (or column) and the first two elements of the second row (or column). 3番目の行 (または列) の2番目の要素からコピーを開始するには、sourceIndex は最初の行 (または列) と2番目の行の長さ (または列) に2を加算した値である必要があります。To start copying from the second element of the third row (or column), sourceIndex must be the upper bound of the first row (or column) plus the length of the second row (or column) plus two.

sourceArraydestinationArray 重複する場合、このメソッドは destinationArray が上書きされる前に sourceArray の元の値が一時的な場所に保持されていたかのように動作します。If sourceArray and destinationArray overlap, this method behaves as if the original values of sourceArray were preserved in a temporary location before destinationArray is overwritten.

[C++][C++]

このメソッドは、memcpy ではC++なく、標準 C/関数 memmove と同じです。This method is equivalent to the standard C/C++ function memmove, not memcpy.

配列には、参照型の配列または値型の配列を指定できます。The arrays can be reference-type arrays or value-type arrays. 必要に応じて、型ダウンキャストが実行されます。Type downcasting is performed, as required.

  • 参照型の配列から値型の配列にコピーする場合、各要素のボックス化が解除されてからコピーされます。When copying from a reference-type array to a value-type array, each element is unboxed and then copied. 値型の配列から参照型の配列にコピーする場合、各要素はボックス化された後にコピーされます。When copying from a value-type array to a reference-type array, each element is boxed and then copied.

  • 参照型または値型の配列から Object 配列にコピーする場合、各値または参照を保持してコピーした後 Object が作成されます。When copying from a reference-type or value-type array to an Object array, an Object is created to hold each value or reference and then copied. Object 配列から参照型または値型の配列にコピーするときに、割り当てができない場合は、InvalidCastException がスローされます。When copying from an Object array to a reference-type or value-type array and the assignment is not possible, an InvalidCastException is thrown.

  • sourceArraydestinationArray の両方が参照型の配列であるか、両方とも Object型の配列である場合、簡易コピーが実行されます。If sourceArray and destinationArray are both reference-type arrays or are both arrays of type Object, a shallow copy is performed. Array の簡易コピーは、元の Arrayと同じ要素への参照を含む新しい Array です。A shallow copy of an Array is a new Array containing references to the same elements as the original Array. 要素自体、または要素によって参照されるものはコピーされません。The elements themselves or anything referenced by the elements are not copied. これに対し、Array の詳細コピーでは、要素と要素によって直接的または間接的に参照されるすべての要素がコピーされます。In contrast, a deep copy of an Array copies the elements and everything directly or indirectly referenced by the elements.

配列の型に互換性がない場合は、ArrayTypeMismatchException がスローされます。An ArrayTypeMismatchException is thrown if the arrays are of incompatible types. 型の互換性は次のように定義されます。Type compatibility is defined as follows:

  • 型は、それ自体と互換性があります。A type is compatible with itself.

  • 値型は、Object およびその値型によって実装されたインターフェイス型と互換性があります。A value type is compatible with Object and with an interface type implemented by that value type. 値型は、インターフェイスを直接実装する場合にのみ、インターフェイスに接続されていると見なされます。A value type is considered connected to an interface only if it implements that interface directly. 切断された型には互換性がありません。Disconnected types are not compatible.

  • ソース型から変換先の型へのコピーが拡大変換である場合、2つの組み込み (定義済み) 値型には互換性があります。Two intrinsic (predefined) value types are compatible if copying from the source type to the destination type is a widening conversion. 拡大変換によって情報が失われることはありませんが、縮小変換によって情報が失われる可能性があります。A widening conversion never loses information, whereas a narrowing conversion can lose information. たとえば、32ビット符号付き整数から64ビット符号付き整数への変換は拡大変換であり、64ビット符号付き整数から32ビット符号付き整数への変換は縮小変換です。For example, converting a 32-bit signed integer to a 64-bit signed integer is a widening conversion, and converting a 64-bit signed integer to a 32-bit signed integer is a narrowing conversion. 変換の詳細については、「Convert」を参照してください。For more information about conversions, see Convert.

  • 非組み込み型 (ユーザー定義) の値型は、それ自体と互換性があるだけです。A nonintrinsic (user-defined) value type is compatible only with itself.

  • 列挙型には、Enum およびその基になる型への暗黙的な変換があります。Enumerations have an implicit conversion to Enum and to their underlying type.

sourceArray のすべての要素にダウンキャストが必要な場合 (たとえば、基本クラスから派生クラス、またはインターフェイスからオブジェクトへのキャスト)、1つ以上の要素を destinationArrayの対応する型にキャストできない場合は InvalidCastException がスローされます。If every element in sourceArray requires a downcast (for example, from a base class to a derived class or from an interface to an object) and one or more elements cannot be cast to the corresponding type in destinationArray, an InvalidCastException is thrown.

コピー中にこのメソッドが例外をスローした場合、destinationArray の状態は未定義になります。If this method throws an exception while copying, the state of destinationArray is undefined.

このメソッドは O(n) 操作です。nlength です。This method is an O(n) operation, where n is length.

こちらもご覧ください

Copy(Array, Array, Int64)

最初の要素を開始位置として Array から要素の範囲をコピーし、最初の要素を開始位置として他の Array にそれらの要素を貼り付けます。Copies a range of elements from an Array starting at the first element and pastes them into another Array starting at the first element. 長さは 64 ビット整数値として指定します。The length is specified as a 64-bit integer.

public:
 static void Copy(Array ^ sourceArray, Array ^ destinationArray, long length);
public static void Copy (Array sourceArray, Array destinationArray, long length);
static member Copy : Array * Array * int64 -> unit
Public Shared Sub Copy (sourceArray As Array, destinationArray As Array, length As Long)

パラメーター

sourceArray
Array

コピーするデータを格納している ArrayThe Array that contains the data to copy.

destinationArray
Array

データを受け取る ArrayThe Array that receives the data.

length
Int64

コピーする要素の数を表す 64 ビット整数。A 64-bit integer that represents the number of elements to copy. この整数は 0 から MaxValue (この値を含む) の間である必要があります。The integer must be between zero and MaxValue, inclusive.

例外

sourceArraynullです。sourceArray is null.

- または --or- destinationArraynull です。destinationArray is null.

sourceArraydestinationArray のランクが異なります。sourceArray and destinationArray have different ranks.

sourceArraydestinationArray の型は互換性がありません。sourceArray and destinationArray are of incompatible types.

sourceArray の少なくとも 1 つの要素が destinationArray の型にキャストできません。At least one element in sourceArray cannot be cast to the type of destinationArray.

length が 0 未満であるか、または MaxValue を超えています。length is less than 0 or greater than MaxValue.

lengthsourceArray にある要素の数を超えています。length is greater than the number of elements in sourceArray.

- または --or- lengthdestinationArray にある要素の数を超えています。length is greater than the number of elements in destinationArray.

注釈

sourceArray パラメーターと destinationArray パラメーターの次元数は同じである必要があります。The sourceArray and destinationArray parameters must have the same number of dimensions. また、destinationArray は既に次元になっている必要があり、コピーされたデータを格納するために十分な数の要素が必要です。In addition, destinationArray must already have been dimensioned and must have a sufficient number of elements to accommodate the copied data.

多次元配列間でコピーを行う場合、配列は長い1次元配列のように動作します。この配列では、行 (または列) が概念的にエンドツーエンドに配置されます。When copying between multidimensional arrays, the array behaves like a long one-dimensional array, where the rows (or columns) are conceptually laid end to end. たとえば、配列に4つの要素を持つ3つの行 (または列) がある場合、配列の先頭から6つの要素をコピーすると、最初の行 (または列) の4つの要素と2番目の行 (または列) の最初の2つの要素がコピーされます。For example, if an array has three rows (or columns) with four elements each, copying six elements from the beginning of the array would copy all four elements of the first row (or column) and the first two elements of the second row (or column).

sourceArraydestinationArray 重複する場合、このメソッドは destinationArray が上書きされる前に sourceArray の元の値が一時的な場所に保持されていたかのように動作します。If sourceArray and destinationArray overlap, this method behaves as if the original values of sourceArray were preserved in a temporary location before destinationArray is overwritten.

[C++][C++]

このメソッドは、memcpy ではC++なく、標準 C/関数 memmove と同じです。This method is equivalent to the standard C/C++ function memmove, not memcpy.

配列には、参照型の配列または値型の配列を指定できます。The arrays can be reference-type arrays or value-type arrays. 必要に応じて、型ダウンキャストが実行されます。Type downcasting is performed, as required.

  • 参照型の配列から値型の配列にコピーする場合、各要素のボックス化が解除されてからコピーされます。When copying from a reference-type array to a value-type array, each element is unboxed and then copied. 値型の配列から参照型の配列にコピーする場合、各要素はボックス化された後にコピーされます。When copying from a value-type array to a reference-type array, each element is boxed and then copied.

  • 参照型または値型の配列から Object 配列にコピーする場合、各値または参照を保持してコピーした後 Object が作成されます。When copying from a reference-type or value-type array to an Object array, an Object is created to hold each value or reference and then copied. Object 配列から参照型または値型の配列にコピーするときに、割り当てができない場合は、InvalidCastException がスローされます。When copying from an Object array to a reference-type or value-type array and the assignment is not possible, an InvalidCastException is thrown.

  • sourceArraydestinationArray の両方が参照型の配列であるか、両方とも Object型の配列である場合、簡易コピーが実行されます。If sourceArray and destinationArray are both reference-type arrays or are both arrays of type Object, a shallow copy is performed. Array の簡易コピーは、元の Arrayと同じ要素への参照を含む新しい Array です。A shallow copy of an Array is a new Array containing references to the same elements as the original Array. 要素自体、または要素によって参照されるものはコピーされません。The elements themselves or anything referenced by the elements are not copied. これに対し、Array の詳細コピーでは、要素と要素によって直接的または間接的に参照されるすべての要素がコピーされます。In contrast, a deep copy of an Array copies the elements and everything directly or indirectly referenced by the elements.

配列の型に互換性がない場合は、ArrayTypeMismatchException がスローされます。An ArrayTypeMismatchException is thrown if the arrays are of incompatible types. 型の互換性は次のように定義されます。Type compatibility is defined as follows:

  • 型は、それ自体と互換性があります。A type is compatible with itself.

  • 値型は、Object およびその値型によって実装されたインターフェイス型と互換性があります。A value type is compatible with Object and with an interface type implemented by that value type. 値型は、インターフェイスを直接実装する場合にのみ、インターフェイスに接続されていると見なされます。A value type is considered connected to an interface only if it implements that interface directly. 切断された型には互換性がありません。Disconnected types are not compatible.

  • ソース型から変換先の型へのコピーが拡大変換である場合、2つの組み込み (定義済み) 値型には互換性があります。Two intrinsic (predefined) value types are compatible if copying from the source type to the destination type is a widening conversion. 拡大変換によって情報が失われることはありませんが、縮小変換によって情報が失われる可能性があります。A widening conversion never loses information, whereas a narrowing conversion can lose information. たとえば、32ビット符号付き整数から64ビット符号付き整数への変換は拡大変換であり、64ビット符号付き整数から32ビット符号付き整数への変換は縮小変換です。For example, converting a 32-bit signed integer to a 64-bit signed integer is a widening conversion, and converting a 64-bit signed integer to a 32-bit signed integer is a narrowing conversion. 変換の詳細については、「Convert」を参照してください。For more information about conversions, see Convert.

  • 非組み込み型 (ユーザー定義) の値型は、それ自体と互換性があるだけです。A nonintrinsic (user-defined) value type is compatible only with itself.

  • 列挙型には、Enum およびその基になる型への暗黙的な変換があります。Enumerations have an implicit conversion to Enum and to their underlying type.

sourceArray のすべての要素にダウンキャストが必要な場合 (たとえば、基本クラスから派生クラス、またはインターフェイスからオブジェクトへのキャスト)、1つ以上の要素を destinationArrayの対応する型にキャストできない場合は InvalidCastException がスローされます。If every element in sourceArray requires a downcast (for example, from a base class to a derived class or from an interface to an object) and one or more elements cannot be cast to the corresponding type in destinationArray, an InvalidCastException is thrown.

コピー中にこのメソッドが例外をスローした場合、destinationArray の状態は未定義になります。If this method throws an exception while copying, the state of destinationArray is undefined.

このメソッドは O(n) 操作です。nlength です。This method is an O(n) operation, where n is length.

こちらもご覧ください

Copy(Array, Array, Int32)

最初の要素を開始位置として Array から要素の範囲をコピーし、最初の要素を開始位置として他の Array にそれらの要素を貼り付けます。Copies a range of elements from an Array starting at the first element and pastes them into another Array starting at the first element. 長さは 32 ビット整数値として指定します。The length is specified as a 32-bit integer.

public:
 static void Copy(Array ^ sourceArray, Array ^ destinationArray, int length);
public static void Copy (Array sourceArray, Array destinationArray, int length);
static member Copy : Array * Array * int -> unit
Public Shared Sub Copy (sourceArray As Array, destinationArray As Array, length As Integer)

パラメーター

sourceArray
Array

コピーするデータを格納している ArrayThe Array that contains the data to copy.

destinationArray
Array

データを受け取る ArrayThe Array that receives the data.

length
Int32

コピーする要素の数を表す 32 ビット整数。A 32-bit integer that represents the number of elements to copy.

例外

sourceArraynullです。sourceArray is null.

- または --or- destinationArraynull です。destinationArray is null.

sourceArraydestinationArray のランクが異なります。sourceArray and destinationArray have different ranks.

sourceArraydestinationArray の型は互換性がありません。sourceArray and destinationArray are of incompatible types.

sourceArray の少なくとも 1 つの要素が destinationArray の型にキャストできません。At least one element in sourceArray cannot be cast to the type of destinationArray.

length が 0 未満です。length is less than zero.

lengthsourceArray にある要素の数を超えています。length is greater than the number of elements in sourceArray.

- または --or- lengthdestinationArray にある要素の数を超えています。length is greater than the number of elements in destinationArray.

注釈

sourceArray パラメーターと destinationArray パラメーターの次元数は同じである必要があります。The sourceArray and destinationArray parameters must have the same number of dimensions. また、destinationArray は既に次元になっている必要があり、コピーされたデータを格納するために十分な数の要素が必要です。In addition, destinationArray must already have been dimensioned and must have a sufficient number of elements to accommodate the copied data.

多次元配列間でコピーを行う場合、配列は長い1次元配列のように動作します。この配列では、行 (または列) が概念的にエンドツーエンドに配置されます。When copying between multidimensional arrays, the array behaves like a long one-dimensional array, where the rows (or columns) are conceptually laid end to end. たとえば、配列に4つの要素を持つ3つの行 (または列) がある場合、配列の先頭から6つの要素をコピーすると、最初の行 (または列) の4つの要素と2番目の行 (または列) の最初の2つの要素がコピーされます。For example, if an array has three rows (or columns) with four elements each, copying six elements from the beginning of the array would copy all four elements of the first row (or column) and the first two elements of the second row (or column).

sourceArraydestinationArray 重複する場合、このメソッドは destinationArray が上書きされる前に sourceArray の元の値が一時的な場所に保持されていたかのように動作します。If sourceArray and destinationArray overlap, this method behaves as if the original values of sourceArray were preserved in a temporary location before destinationArray is overwritten.

[C++][C++]

このメソッドは、memcpy ではC++なく、標準 C/関数 memmove と同じです。This method is equivalent to the standard C/C++ function memmove, not memcpy.

配列には、参照型の配列または値型の配列を指定できます。The arrays can be reference-type arrays or value-type arrays. 必要に応じて、型ダウンキャストが実行されます。Type downcasting is performed, as required.

  • 参照型の配列から値型の配列にコピーする場合、各要素のボックス化が解除されてからコピーされます。When copying from a reference-type array to a value-type array, each element is unboxed and then copied. 値型の配列から参照型の配列にコピーする場合、各要素はボックス化された後にコピーされます。When copying from a value-type array to a reference-type array, each element is boxed and then copied.

  • 参照型または値型の配列から Object 配列にコピーする場合、各値または参照を保持してコピーした後 Object が作成されます。When copying from a reference-type or value-type array to an Object array, an Object is created to hold each value or reference and then copied. Object 配列から参照型または値型の配列にコピーするときに、割り当てができない場合は、InvalidCastException がスローされます。When copying from an Object array to a reference-type or value-type array and the assignment is not possible, an InvalidCastException is thrown.

  • sourceArraydestinationArray の両方が参照型の配列であるか、両方とも Object型の配列である場合、簡易コピーが実行されます。If sourceArray and destinationArray are both reference-type arrays or are both arrays of type Object, a shallow copy is performed. Array の簡易コピーは、元の Arrayと同じ要素への参照を含む新しい Array です。A shallow copy of an Array is a new Array containing references to the same elements as the original Array. 要素自体、または要素によって参照されるものはコピーされません。The elements themselves or anything referenced by the elements are not copied. これに対し、Array の詳細コピーでは、要素と要素によって直接的または間接的に参照されるすべての要素がコピーされます。In contrast, a deep copy of an Array copies the elements and everything directly or indirectly referenced by the elements.

配列の型に互換性がない場合は、ArrayTypeMismatchException がスローされます。An ArrayTypeMismatchException is thrown if the arrays are of incompatible types. 型の互換性は次のように定義されます。Type compatibility is defined as follows:

  • 型は、それ自体と互換性があります。A type is compatible with itself.

  • 値型は、Object およびその値型によって実装されたインターフェイス型と互換性があります。A value type is compatible with Object and with an interface type implemented by that value type. 値型は、インターフェイスを直接実装する場合にのみ、インターフェイスに接続されていると見なされます。A value type is considered connected to an interface only if it implements that interface directly. 切断された型には互換性がありません。Disconnected types are not compatible.

  • ソース型から変換先の型へのコピーが拡大変換である場合、2つの組み込み (定義済み) 値型には互換性があります。Two intrinsic (predefined) value types are compatible if copying from the source type to the destination type is a widening conversion. 拡大変換によって情報が失われることはありませんが、縮小変換によって情報が失われる可能性があります。A widening conversion never loses information, whereas a narrowing conversion can lose information. たとえば、32ビット符号付き整数から64ビット符号付き整数への変換は拡大変換であり、64ビット符号付き整数から32ビット符号付き整数への変換は縮小変換です。For example, converting a 32-bit signed integer to a 64-bit signed integer is a widening conversion, and converting a 64-bit signed integer to a 32-bit signed integer is a narrowing conversion. 変換の詳細については、「Convert」を参照してください。For more information about conversions, see Convert.

  • 非組み込み型 (ユーザー定義) の値型は、それ自体と互換性があるだけです。A nonintrinsic (user-defined) value type is compatible only with itself.

  • 列挙型には、Enum およびその基になる型への暗黙的な変換があります。Enumerations have an implicit conversion to Enum and to their underlying type.

sourceArray のすべての要素にダウンキャストが必要な場合 (たとえば、基本クラスから派生クラス、またはインターフェイスからオブジェクトへのキャスト)、1つ以上の要素を destinationArrayの対応する型にキャストできない場合は InvalidCastException がスローされます。If every element in sourceArray requires a downcast (for example, from a base class to a derived class or from an interface to an object) and one or more elements cannot be cast to the corresponding type in destinationArray, an InvalidCastException is thrown.

コピー中にこのメソッドが例外をスローした場合、destinationArray の状態は未定義になります。If this method throws an exception while copying, the state of destinationArray is undefined.

このメソッドは O(n) 操作です。nlength です。This method is an O(n) operation, where n is length.

こちらもご覧ください

適用対象