Array.CreateInstanceFromArrayType 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

重载

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

CreateInstanceFromArrayType(Type, Int32[])

Source:

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。

例外

ArgumentNullException

arrayType null。

-或-

lengths null。

ArgumentOutOfRangeException

lengths 中的任何值都小于零。

ArgumentException

长度数组为空。

-或-

arrayType 不是数组类型。

-或-

arrayType 排名与 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

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

例外

ArgumentNullException

arrayType null。

ArgumentOutOfRangeException

length 为负数。

ArgumentException

arrayType 不是数组类型。

-或-

arrayType 不是一维数组。

注解

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

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

Source:

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 友好。