Array.CreateInstanceFromArrayType 方法

定義

命名空間:
System
組件:
netstandard.dll, System.Runtime.dll

多載

名稱 Description
CreateInstanceFromArrayType(Type, Int32[])

建立指定Array長度與維度長度的多維Type度，並以零為基礎的索引。
CreateInstanceFromArrayType(Type, Int32)

建立指定陣列類型與長度的一維 Array ，並以零為基礎的索引。
CreateInstanceFromArrayType(Type, Int32[], Int32[])

建立指定Array長度與維度長度的多維Type空間，並設定下界。

CreateInstanceFromArrayType(Type, Int32[])

來源:
Array.cs
來源:
Array.cs
來源:
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 排名不等 lengths 於長度。

備註

當陣列類型容易取得時，應優先 CreateInstance(Type, Int32[])使用此方法，因為它效能較佳且適合 AOT。

適用於

CreateInstanceFromArrayType(Type, Int32)

來源:
Array.cs
來源:
Array.cs
來源:
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

一個新的一維ArrayType，具有指定長度。

例外狀況

ArgumentNullException

arrayType 是 null。

ArgumentOutOfRangeException

length 為負數。

ArgumentException

arrayType 不是陣列類型。

-或-

arrayType 不是一維陣列。

備註

當陣列類型容易取得時，應優先 CreateInstance(Type, Int32)使用此方法，因為它效能較佳且適合 AOT。

適用於

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

來源:
Array.cs
來源:
Array.cs
來源:
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

一個新的多維 Array 度， Type 每個維度的長度和下界都指定。

例外狀況

ArgumentNullException

arrayType 是 null。

-或-

lengths 是 null。

-或-

lowerBounds 是 null。

ArgumentException

lengths和 lowerBounds 陣列包含的元素數量並不相同。

-或-

長度陣列為空。

-或-

arrayType 不是陣列類型。

-或-

arrayType 排名不等 lengths 於長度。

ArgumentOutOfRangeException

任何 的 lengths 值都小於零。

PlatformNotSupportedException

原生進攻：任何值 lowerBounds 都不等於零。

備註

當陣列類型容易取得時，應優先 CreateInstance(Type, Int32[], Int32[])使用此方法，因為它效能較佳且適合 AOT。

適用於