Array.CreateInstance 메서드

728x90

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args)
        {

            Array myArr1 = Array.CreateInstance(typeof(int),10);
            Console.Write($"myArr1.GetLowerBound(0) : {myArr1.GetLowerBound(0)}    "); //0
            Console.Write($"myArr1.GetUpperBound(0) : {myArr1.GetUpperBound(0)}    "); //9
            Console.WriteLine();
            for (int i = myArr1.GetLowerBound(0); i <= myArr1.GetUpperBound(0); i++) //<=로 써야함!
            {
                myArr1.SetValue(i*10,i);
                Console.Write($"    {myArr1.GetValue(i)}    ");
            }
        }
    }
}

출력

    0        10        20        30        40        50        60        70        80        90

Array.CreateInstance 메서드 (System)

Array 클래스의 새 인스턴스를 초기화합니다.

learn.microsoft.com

정의

Array 클래스의 새 인스턴스를 초기화합니다.

오버로드

CreateInstance(Type, Int32)	지정한 Type 및 길이를 가진 인덱스가 0부터 시작하는 1차원 Array를 만듭니다.
CreateInstance(Type, Int32[])	지정한 Type 및 차원 길이를 가진 인덱스가 0부터 시작하는 다차원 Array를 만듭니다. 차원 길이가 32비트 정수 배열로 지정되어 있습니다.
CreateInstance(Type, Int64[])	지정한 Type 및 차원 길이를 가진 인덱스가 0부터 시작하는 다차원 Array를 만듭니다. 차원 길이가 64비트 정수 배열로 지정되어 있습니다.
CreateInstance(Type, Int32, Int32)	0부터 시작하는 인덱스를 사용하여 지정된 Type 및 차원 길이의 2차원 Array를 만듭니다.
CreateInstance(Type, Int32[], Int32[])	지정한 하한을 사용하여 지정한 Array 및 차원 길이의 다차원 Type 을 만듭니다.
CreateInstance(Type, Int32, Int32, Int32)	지정한 Type 및 차원 길이를 가진 인덱스가 0부터 시작하는 삼차원 Array를 만듭니다.

CreateInstance(Type, Int32)

지정한 Type 및 길이를 가진 인덱스가 0부터 시작하는 1차원 Array를 만듭니다.

public static Array CreateInstance (Type elementType, int length);

예제

다음 코드 예제에서는 1차원 Array을 만들고 초기화하는 방법을 보여줍니다.

using System;
public class SamplesArray  {

   public static void Main()  {

      // Creates and initializes a one-dimensional Array of type int.
      Array my1DArray=Array.CreateInstance( typeof(int), 5 );
      for ( int i = my1DArray.GetLowerBound(0); i <= my1DArray.GetUpperBound(0); i++ )
         my1DArray.SetValue( i+1, i );

      // Displays the values of the Array.
      Console.WriteLine( "The one-dimensional Array contains the following values:" );
      PrintValues( my1DArray );
   }

   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.

The one-dimensional Array contains the following values:
    1    2    3    4    5
*/

CreateInstance(Type, Int32[])

지정한 Type 및 차원 길이를 가진 인덱스가 0부터 시작하는 다차원 Array를 만듭니다. 차원 길이가 32비트 정수 배열로 지정되어 있습니다.

public static Array CreateInstance (Type elementType, params int[] lengths);

예제

다음 코드 예제에서는 다차원을 만들고 초기화하는 방법을 보여 줍니다 Array.

using System;
public class SamplesArray3  {

   public static void Main()  {

      // Creates and initializes a multidimensional Array of type string.
      int[] myLengthsArray = new int[4] { 2, 3, 4, 5 };
      Array my4DArray=Array.CreateInstance( typeof(string), myLengthsArray );
      for ( int i = my4DArray.GetLowerBound(0); i <= my4DArray.GetUpperBound(0); i++ )
         for ( int j = my4DArray.GetLowerBound(1); j <= my4DArray.GetUpperBound(1); j++ )
            for ( int k = my4DArray.GetLowerBound(2); k <= my4DArray.GetUpperBound(2); k++ )
               for ( int l = my4DArray.GetLowerBound(3); l <= my4DArray.GetUpperBound(3); l++ )  {
                  int[] myIndicesArray = new int[4] { i, j, k, l };
                  my4DArray.SetValue( Convert.ToString(i) + j + k + l, myIndicesArray );
               }

      // Displays the values of the Array.
      Console.WriteLine( "The four-dimensional Array contains the following values:" );
      PrintValues( my4DArray );
   }

   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.

The four-dimensional Array contains the following values:
    0000    0001    0002    0003    0004
    0010    0011    0012    0013    0014
    0020    0021    0022    0023    0024
    0030    0031    0032    0033    0034
    0100    0101    0102    0103    0104
    0110    0111    0112    0113    0114
    0120    0121    0122    0123    0124
    0130    0131    0132    0133    0134
    0200    0201    0202    0203    0204
    0210    0211    0212    0213    0214
    0220    0221    0222    0223    0224
    0230    0231    0232    0233    0234
    1000    1001    1002    1003    1004
    1010    1011    1012    1013    1014
    1020    1021    1022    1023    1024
    1030    1031    1032    1033    1034
    1100    1101    1102    1103    1104
    1110    1111    1112    1113    1114
    1120    1121    1122    1123    1124
    1130    1131    1132    1133    1134
    1200    1201    1202    1203    1204
    1210    1211    1212    1213    1214
    1220    1221    1222    1223    1224
    1230    1231    1232    1233    1234
*/

설명

대부분의 클래스와 Array 달리 공용 생성자 대신 메서드를 제공하여 CreateInstance 런타임에 바인딩된 액세스를 허용합니다.

배열의 요소 lengths 수는 새 Array차원의 수와 같아야 합니다. 배열의 lengths 각 요소는 새 Array차원의 길이를 지정해야 합니다.

참조 형식 요소가 .로 null초기화됩니다. 값 형식 요소는 0으로 초기화됩니다.

이 메서드는 O(n) 연산입니다. 여기서 n 모든 값의 곱은 다음과 같습니다 lengths.

적용 대상

.NET 7 RC 1 및 기타 버전

CreateInstance(Type, Int64[])

지정한 Type 및 차원 길이를 가진 인덱스가 0부터 시작하는 다차원 Array를 만듭니다. 차원 길이가 64비트 정수 배열로 지정되어 있습니다.

public static Array CreateInstance (Type elementType, params long[] lengths);

매개 변수

elementType Type

만들 Array의 Type입니다.

lengths Int64[]

만들 Array의 각 차원 크기를 나타내는 64비트 정수 배열입니다. 배열의 각 정수는 0과 Int32.MaxValue(포함) 사이여야 합니다.

반환

Array

지정한 Type 및 각 차원에 대해 지정한 길이를 가진 인덱스가 0부터 시작하는 새 다차원 Array입니다.

예외

ArgumentNullException

elementType이(가) null인 경우

또는

lengths이(가) null인 경우

ArgumentException

elementType은 유효한 Type이 아닙니다.

또는

lengths 배열에 1개 미만의 요소가 포함되어 있습니다.

NotSupportedException

elementType은 지원되지 않습니다. 예를 들면 Void는 지원되지 않습니다.

또는

elementType이 개방형 제네릭 형식인 경우.

ArgumentOutOfRangeException

모든 lengths 값이 0보다 작거나 Int32.MaxValue보다 큽니다.

예제

다음 코드 예제에서는 다차원을 만들고 초기화하는 방법을 보여 줍니다 Array.

using System;
public class SamplesArray3  {

   public static void Main()  {

      // Creates and initializes a multidimensional Array of type string.
      int[] myLengthsArray = new int[4] { 2, 3, 4, 5 };
      Array my4DArray=Array.CreateInstance( typeof(string), myLengthsArray );
      for ( int i = my4DArray.GetLowerBound(0); i <= my4DArray.GetUpperBound(0); i++ )
         for ( int j = my4DArray.GetLowerBound(1); j <= my4DArray.GetUpperBound(1); j++ )
            for ( int k = my4DArray.GetLowerBound(2); k <= my4DArray.GetUpperBound(2); k++ )
               for ( int l = my4DArray.GetLowerBound(3); l <= my4DArray.GetUpperBound(3); l++ )  {
                  int[] myIndicesArray = new int[4] { i, j, k, l };
                  my4DArray.SetValue( Convert.ToString(i) + j + k + l, myIndicesArray );
               }

      // Displays the values of the Array.
      Console.WriteLine( "The four-dimensional Array contains the following values:" );
      PrintValues( my4DArray );
   }

   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.

The four-dimensional Array contains the following values:
    0000    0001    0002    0003    0004
    0010    0011    0012    0013    0014
    0020    0021    0022    0023    0024
    0030    0031    0032    0033    0034
    0100    0101    0102    0103    0104
    0110    0111    0112    0113    0114
    0120    0121    0122    0123    0124
    0130    0131    0132    0133    0134
    0200    0201    0202    0203    0204
    0210    0211    0212    0213    0214
    0220    0221    0222    0223    0224
    0230    0231    0232    0233    0234
    1000    1001    1002    1003    1004
    1010    1011    1012    1013    1014
    1020    1021    1022    1023    1024
    1030    1031    1032    1033    1034
    1100    1101    1102    1103    1104
    1110    1111    1112    1113    1114
    1120    1121    1122    1123    1124
    1130    1131    1132    1133    1134
    1200    1201    1202    1203    1204
    1210    1211    1212    1213    1214
    1220    1221    1222    1223    1224
    1230    1231    1232    1233    1234
*/

설명

대부분의 클래스와 Array 달리 공용 생성자 대신 메서드를 제공하여 CreateInstance 런타임에 바인딩된 액세스를 허용합니다.

배열의 요소 lengths 수는 새 Array차원의 수와 같아야 합니다. 배열의 lengths 각 요소는 새 Array차원의 길이를 지정해야 합니다.

참조 형식 요소가 .로 null초기화됩니다. 값 형식 요소는 0으로 초기화됩니다.

이 메서드는 O(n) 연산입니다. 여기서 n 모든 값의 곱은 다음과 같습니다 lengths.

적용 대상

.NET 7 RC 1 및 기타 버전

CreateInstance(Type, Int32, Int32)

0부터 시작하는 인덱스를 사용하여 지정된 Type 및 차원 길이의 2차원 Array를 만듭니다.

public static Array CreateInstance (Type elementType, int length1, int length2);

매개 변수

elementType Type

만들 Array의 Type입니다.

length1 Int32

만들 Array의 첫 번째 차원 크기입니다.

length2 Int32

만들 Array의 두 번째 차원 크기입니다.

반환

Array

0부터 시작하는 인덱스를 사용하며 각 차원이 지정된 길이로 된 지정된 Type의 새로운 2차원 Array입니다.

예외

ArgumentNullException

elementType이(가) null인 경우

ArgumentException

elementType은 유효한 Type이 아닙니다.

NotSupportedException

elementType은 지원되지 않습니다. 예를 들면 Void는 지원되지 않습니다.

또는

elementType이 개방형 제네릭 형식인 경우.

ArgumentOutOfRangeException

length1가 0보다 작은 경우

또는

length2가 0보다 작은 경우

예제

다음 코드 예제에서는 2차원 Array을 만들고 초기화하는 방법을 보여줍니다.

using System;
public class SamplesArray1  {

   public static void Main()  {

      // Creates and initializes a two-dimensional Array of type string.
      Array my2DArray=Array.CreateInstance( typeof(string), 2, 3 );
      for ( int i = my2DArray.GetLowerBound(0); i <= my2DArray.GetUpperBound(0); i++ )
         for ( int j = my2DArray.GetLowerBound(1); j <= my2DArray.GetUpperBound(1); j++ )
            my2DArray.SetValue( "abc" + i + j, i, j );

      // Displays the values of the Array.
      Console.WriteLine( "The two-dimensional Array contains the following values:" );
      PrintValues( my2DArray );
   }

   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.

The two-dimensional Array contains the following values:
    abc00    abc01    abc02
    abc10    abc11    abc12
*/

설명

대부분의 클래스와 Array 달리 공용 생성자 대신 메서드를 제공하여 CreateInstance 런타임에 바인딩된 액세스를 허용합니다.

참조 형식 요소가 .로 null초기화됩니다. 값 형식 요소는 0으로 초기화됩니다.

이 메서드는 O(n) 연산이며, 여기서 곱 length1 은 다음과 n 같습니다length2.

F#에서는 Array2D.zeroCreate 함수를 대신 사용할 수 있습니다.

적용 대상

.NET 7 RC 1 및 기타 버전

CreateInstance(Type, Int32[], Int32[])

지정한 하한을 사용하여 지정한 Array 및 차원 길이의 다차원 Type 을 만듭니다.

public static Array CreateInstance (Type elementType, int[] lengths, int[] lowerBounds);

매개 변수

elementType Type

만들 Array의 Type입니다.

lengths Int32[]

만들 Array 의 각 차원 크기를 포함하는 1차원 배열입니다.

lowerBounds Int32[]

만들 Array 의 각 차원 하한(시작 인덱스)을 포함하는 1차원 배열입니다.

반환

Array

각 차원에 대해 지정한 길이 및 하한을 가진 지정한 Array 의 새 다차원 Type 입니다.

예외

ArgumentNullException

elementType이(가) null인 경우

또는

lengths이(가) null인 경우

또는

lowerBounds이(가) null인 경우

ArgumentException

elementType은 유효한 Type이 아닙니다.

또는

lengths 배열에 1개 미만의 요소가 포함되어 있습니다.

또는

lengths와 lowerBounds 배열에 들어 있는 요소 수가 다른 경우

NotSupportedException

elementType은 지원되지 않습니다. 예를 들면 Void는 지원되지 않습니다.

또는

elementType이 개방형 제네릭 형식인 경우.

ArgumentOutOfRangeException

lengths의 값이 0보다 작습니다.

또는

lowerBounds 차원의 하한 및 길이 합계가 Int32.MaxValue보다 크면 값이 매우 큽습니다.

예제

다음 코드 예제에서는 지정된 하한을 사용하여 다차원 Array 을 만들고 초기화하는 방법을 보여 줍니다.

using System;
public class SamplesArray4  {

   public static void Main()  {

      // Creates and initializes a multidimensional Array of type string.
      int[] myLengthsArray = new int[2] { 3, 5 };
      int[] myBoundsArray = new int[2] { 2, 3 };
      Array myArray=Array.CreateInstance( typeof(string), myLengthsArray, myBoundsArray );
      for ( int i = myArray.GetLowerBound(0); i <= myArray.GetUpperBound(0); i++ )
         for ( int j = myArray.GetLowerBound(1); j <= myArray.GetUpperBound(1); j++ )  {
            int[] myIndicesArray = new int[2] { i, j };
            myArray.SetValue( Convert.ToString(i) + j, myIndicesArray );
         }

      // Displays the lower bounds and the upper bounds of each dimension.
      Console.WriteLine( "Bounds:\tLower\tUpper" );
      for ( int i = 0; i < myArray.Rank; i++ )
         Console.WriteLine( "{0}:\t{1}\t{2}", i, myArray.GetLowerBound(i), myArray.GetUpperBound(i) );

      // Displays the values of the Array.
      Console.WriteLine( "The Array contains the following values:" );
      PrintValues( myArray );
   }

   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.

Bounds:    Lower    Upper
0:    2    4
1:    3    7
The Array contains the following values:
    23    24    25    26    27
    33    34    35    36    37
    43    44    45    46    47
*/

설명

대부분의 클래스와 Array 달리 공용 생성자 대신 메서드를 제공하여 CreateInstance 런타임에 바인딩된 액세스를 허용합니다.

lengths 배열과 lowerBounds 배열의 개수는 같아야 합니다. 배열의 요소 lengths 수는 새 Array차원의 수와 같아야 합니다.

배열의 lengths 각 요소는 새 Array차원의 길이를 지정해야 합니다.

배열의 lowerBounds 각 요소는 새 Array차원의 하한을 지정해야 합니다. 일반적으로 .NET 클래스 라이브러리와 많은 프로그래밍 언어는 0이 아닌 하한을 처리하지 않습니다.

참조 형식 요소가 .로 null초기화됩니다. 값 형식 요소는 0으로 초기화됩니다.

이 메서드는 O(n) 연산입니다. 여기서 n 모든 값의 곱은 다음과 같습니다 lengths.

참고

모든 언어가 0이 아닌 하한이 있는 배열을 지원하지 않으므로 언어의 배열 형식에 따라 Array 0이 아닌 인스턴스를 캐스팅하지 못할 수 있습니다. 예를 들어 하한이 6인 1차원 정수 배열은 C#의 int[] 형식으로 캐스팅할 수 없습니다. InvalidCastException 그러면 런타임 중에 "'System.Int32[]' 형식의 개체를 'System.Int32[*]' 형식으로 캐스팅할 수 없습니다."라는 메시지가 표시됩니다. 여기서 별표(*)는 0이 아닌 인덱스를 의미합니다. 그러나 언어의 배열로 만든 CreateInstance(Type, Int32[], Int32[]) 모든 순위의 0부터 시작하는 배열을 캐스팅할 수 있습니다. 예를 들어 이 메서드를 사용하여 만든 2차원 0 기반 정수 배열을 C#의 int[,] 형식으로 캐스팅할 수 있습니다.

적용 대상

.NET 7 RC 1 및 기타 버전

CreateInstance(Type, Int32, Int32, Int32)

지정한 Type 및 차원 길이를 가진 인덱스가 0부터 시작하는 삼차원 Array를 만듭니다.

public static Array CreateInstance (Type elementType, int length1, int length2, int length3);

예제

다음 코드 예제에서는 3차원 Array을 만들고 초기화하는 방법을 보여줍니다.

using System;
public class SamplesArray2  {

   public static void Main()  {

      // Creates and initializes a three-dimensional Array of type Object.
      Array my3DArray=Array.CreateInstance( typeof(Object), 2, 3, 4 );
      for ( int i = my3DArray.GetLowerBound(0); i <= my3DArray.GetUpperBound(0); i++ )
         for ( int j = my3DArray.GetLowerBound(1); j <= my3DArray.GetUpperBound(1); j++ )
            for ( int k = my3DArray.GetLowerBound(2); k <= my3DArray.GetUpperBound(2); k++ )
               my3DArray.SetValue( "abc" + i + j + k, i, j, k );

      // Displays the values of the Array.
      Console.WriteLine( "The three-dimensional Array contains the following values:" );
      PrintValues( my3DArray );
   }

   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.

The three-dimensional Array contains the following values:
    abc000    abc001    abc002    abc003
    abc010    abc011    abc012    abc013
    abc020    abc021    abc022    abc023
    abc100    abc101    abc102    abc103
    abc110    abc111    abc112    abc113
    abc120    abc121    abc122    abc123
*/

설명

대부분의 클래스와 Array 달리, 런타임에 CreateInstance 바인딩된 액세스를 허용하기 위해 공용 생성자 대신 메서드를 제공합니다.

참조 형식 요소가 .로 null초기화됩니다. 값 형식 요소는 0으로 초기화됩니다.

This method is an O(n) operation, where n is the product of length1, length2, and length3.

F#에서 Array3D.zeroCreate 함수를 대신 사용할 수 있습니다.

728x90

'C# > C#' 카테고리의 다른 글

[C#] 정수 숫자 형식 (0)	2022.06.11
클래스를 배열로 선언하기 (0)	2022.02.24
필드, 멤버, 지역변수, 정적필드, 정적 메소드 개념 정리 (0)	2022.02.14
[C#]문자열 출력 여러가지 방법 (0)	2022.02.04
[C# 콘솔] 5x5 동그라미판 출력 (0)	2022.02.02

정의

오버로드

CreateInstance(Type, Int32)

예제

CreateInstance(Type, Int32[])

예제

설명

적용 대상

CreateInstance(Type, Int64[])

매개 변수

반환

예외

예제

설명

적용 대상

CreateInstance(Type, Int32, Int32)

매개 변수

반환

예외

예제

설명

적용 대상

CreateInstance(Type, Int32[], Int32[])

매개 변수

반환

예외

예제

설명

적용 대상

CreateInstance(Type, Int32, Int32, Int32)

예제

설명

'C# > C#' 카테고리의 다른 글

티스토리툴바