Array.CreateInstanceFromArrayType 方法

定義

命名空間:

System

組件:

System.Runtime.dll

多載

CreateInstanceFromArrayType(Type, Int32[])	使用以零起始的索引，建立指定之 Type 和維度長度的多維度 Array。
CreateInstanceFromArrayType(Type, Int32)	使用以零起始的索引，建立指定數位類型和長度的一維 Array。
CreateInstanceFromArrayType(Type, Int32[], Int32[])	使用指定的下限，建立指定之 Type 和維度長度的多維度 Array。

CreateInstanceFromArrayType(Type, Int32[])

來源:

Array.cs

使用以零起始的索引，建立指定之 Type 和維度長度的多維度 Array。

public:
 static Array ^ CreateInstanceFromArrayType(Type ^ arrayType, ... cli::array <int> ^ lengths);

public static Array CreateInstanceFromArrayType (Type arrayType, params int[] lengths);

static member CreateInstanceFromArrayType : Type * int[] -> Array

Public Shared Function CreateInstanceFromArrayType (arrayType As Type, ParamArray lengths As Integer()) As Array

參數

arrayType

Type

陣列的類型（不是陣列項目類型）。

lengths

Int32[]

維度長度，指定於32位整數的陣列中。

傳回

Array

新的多維度 Array 指定的 Type，使用以零起始的索引，為每個維度指定長度。

例外狀況

ArgumentNullException

arrayType null。

-或-

lengths null。

ArgumentOutOfRangeException

lengths 中的任何值都小於零。

ArgumentException

長度陣列是空的。

-或-

arrayType 不是數位類型。

-或-

arrayType 排名與長度不相符 lengths。

備註

當陣列類型可供使用時，這個方法應該優先於 CreateInstance(Type, Int32[])，因為它具有較佳的效能，而且適合使用 AOT。

CreateInstanceFromArrayType(Type, Int32)

來源:

Array.cs

使用以零起始的索引，建立指定數位類型和長度的一維 Array。

public:
 static Array ^ CreateInstanceFromArrayType(Type ^ arrayType, int length);

public static Array CreateInstanceFromArrayType (Type arrayType, int length);

static member CreateInstanceFromArrayType : Type * int -> Array

Public Shared Function CreateInstanceFromArrayType (arrayType As Type, length As Integer) As Array

參數

arrayType

Type

陣列的類型（不是陣列項目類型）。

length

Int32

要建立之 Array 的大小。

傳回

Array

具有指定長度之指定之 Type 的新一維 Array。

例外狀況

ArgumentNullException

arrayType null。

ArgumentOutOfRangeException

length 為負數。

ArgumentException

arrayType 不是數位類型。

-或-

arrayType 不是一維陣列。

備註

當陣列類型可供使用時，這個方法應該優先於 CreateInstance(Type, Int32)，因為它具有較佳的效能，而且適合使用 AOT。

CreateInstanceFromArrayType(Type, Int32[], Int32[])

來源:

Array.cs

使用指定的下限，建立指定之 Type 和維度長度的多維度 Array。

public:
 static Array ^ CreateInstanceFromArrayType(Type ^ arrayType, cli::array <int> ^ lengths, cli::array <int> ^ lowerBounds);

public static Array CreateInstanceFromArrayType (Type arrayType, int[] lengths, int[] lowerBounds);

static member CreateInstanceFromArrayType : Type * int[] * int[] -> Array

Public Shared Function CreateInstanceFromArrayType (arrayType As Type, lengths As Integer(), lowerBounds As Integer()) As Array

參數

arrayType

Type

陣列的類型（不是陣列項目類型）。

lengths

Int32[]

維度長度，指定於32位整數的陣列中。

lowerBounds

Int32[]

一維陣列，其中包含要建立之 Array 每個維度的下限（起始索引）。

傳回

Array

指定之 Type 的新多維度 Array，每個維度的指定長度和下限。

例外狀況

ArgumentNullException

arrayType null。

-或-

lengths null。

-或-

lowerBounds null。

ArgumentException

lengths 和 lowerBounds 陣列不包含相同數目的專案。

-或-

長度陣列是空的。

-或-

arrayType 不是數位類型。

-或-

arrayType 排名與長度不相符 lengths。

ArgumentOutOfRangeException

lengths 中的任何值都小於零。

PlatformNotSupportedException

原生 AOT：lowerBounds 中的任何值都與零不同。

備註

當陣列類型可供使用時，這個方法應該優先於 CreateInstance(Type, Int32[], Int32[])，因為它具有較佳的效能，而且適合使用 AOT。