Array.CreateInstanceFromArrayType 方法

定义

命名空间:

System

程序集:

netstandard.dll, System.Runtime.dll

重载

名称	说明
CreateInstanceFromArrayType(Type, Int32[])	使用从零开始的索引创建指定Array长度和维度长度的多维Type。
CreateInstanceFromArrayType(Type, Int32)	创建具有从零开始的索引的指定数组类型和长度的一维 Array 。
CreateInstanceFromArrayType(Type, Int32[], Int32[])	使用指定的下限创建指定Array长度和维度长度的多维Type。

CreateInstanceFromArrayType(Type, Int32[])

Source:

Array.cs

使用从零开始的索引创建指定Array长度和维度长度的多维Type。

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 指定类型，每个维度的指定长度，使用从零开始的索引。

例外

ArgumentNullException

arrayType 是 null。

-或者-

lengths 是 null。

ArgumentOutOfRangeException

任何值中的 lengths 值都小于零。

ArgumentException

长度数组为空。

-或者-

arrayType 不是数组类型。

-或者-

arrayType rank 与长度不匹配 lengths 。

注解

当数组类型随时可用时，此方法应优先于 CreateInstance(Type, Int32[])此方法，因为它具有更好的性能，并且它与 AOT 友好。

CreateInstanceFromArrayType(Type, Int32)

Source:

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

具有指定长度的指定Array的新一维Type。

例外

ArgumentNullException

arrayType 是 null。

ArgumentOutOfRangeException

length 为负数。

ArgumentException

arrayType 不是数组类型。

-或者-

arrayType 不是一维数组。

注解

当数组类型随时可用时，此方法应优先于 CreateInstance(Type, Int32)此方法，因为它具有更好的性能，并且它与 AOT 友好。

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

Source:

Array.cs

使用指定的下限创建指定Array长度和维度长度的多维Type。

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

指定的新多维ArrayType，每个维度的指定长度和下限。

例外

ArgumentNullException

arrayType 是 null。

-或者-

lengths 是 null。

-或者-

lowerBounds 是 null。

ArgumentException

和lengthslowerBounds数组不包含相同数量的元素。

-或者-

长度数组为空。

-或者-

arrayType 不是数组类型。

-或者-

arrayType rank 与长度不匹配 lengths 。

ArgumentOutOfRangeException

任何值中的 lengths 值都小于零。

PlatformNotSupportedException

本机 AOT：任何值与 lowerBounds 零不同。

注解

当数组类型随时可用时，此方法应优先于 CreateInstance(Type, Int32[], Int32[])此方法，因为它具有更好的性能，并且它与 AOT 友好。