Array.CreateInstanceFromArrayType Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Sobrecargas

CreateInstanceFromArrayType(Type, Int32[])	Cria uma Array multidimensional dos comprimentos de Type e dimensão especificados, com indexação baseada em zero.
CreateInstanceFromArrayType(Type, Int32)	Cria uma Array unidimensional do tipo e do comprimento da matriz especificados, com indexação baseada em zero.
CreateInstanceFromArrayType(Type, Int32[], Int32[])	Cria uma Array multidimensional dos comprimentos de Type e dimensão especificados, com os limites inferiores especificados.

CreateInstanceFromArrayType(Type, Int32[])

Origem:

Array.cs

Cria uma Array multidimensional dos comprimentos de Type e dimensão especificados, com indexação baseada em zero.

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

Parâmetros

arrayType

Type

O tipo da matriz (não do tipo de elemento de matriz).

lengths

Int32[]

Os comprimentos da dimensão, especificados em uma matriz de inteiros de 32 bits.

Retornos

Array

Uma nova Array multidimensional do Tipo especificado com o comprimento especificado para cada dimensão, usando indexação baseada em zero.

Exceções

ArgumentNullException

arrayType é null.

-ou-

lengths é null.

ArgumentOutOfRangeException

Qualquer valor em lengths é menor que zero.

ArgumentException

A matriz de comprimentos está vazia.

-ou-

arrayType não é um tipo de matriz.

-ou-

arrayType classificação não corresponde lengths comprimento.

Comentários

Quando o tipo de matriz está prontamente disponível, esse método deve ser preferencial em vez de CreateInstance(Type, Int32[]), pois tem melhor desempenho e é amigável ao AOT.

CreateInstanceFromArrayType(Type, Int32)

Origem:

Array.cs

Cria uma Array unidimensional do tipo e do comprimento da matriz especificados, com indexação baseada em zero.

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

Parâmetros

arrayType

Type

O tipo da matriz (não do tipo de elemento de matriz).

length

Int32

O tamanho do Array a ser criado.

Retornos

Array

Um novo Array unidimensional do Type especificado com o comprimento especificado.

Exceções

ArgumentNullException

arrayType é null.

ArgumentOutOfRangeException

length é negativo.

ArgumentException

arrayType não é um tipo de matriz.

-ou-

arrayType não é uma matriz unidimensional.

Comentários

Quando o tipo de matriz está prontamente disponível, esse método deve ser preferencial em vez de CreateInstance(Type, Int32), pois tem melhor desempenho e é amigável ao AOT.

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

Origem:

Array.cs

Cria uma Array multidimensional dos comprimentos de Type e dimensão especificados, com os limites inferiores especificados.

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

Parâmetros

arrayType

Type

O tipo da matriz (não do tipo de elemento de matriz).

lengths

Int32[]

Os comprimentos da dimensão, especificados em uma matriz de inteiros de 32 bits.

lowerBounds

Int32[]

Uma matriz unidimensional que contém o limite inferior (índice inicial) de cada dimensão da Array a ser criada.

Retornos

Array

Uma nova Array multidimensional do Type especificado com o comprimento e o limite inferior especificados para cada dimensão.

Exceções

ArgumentNullException

arrayType é null.

-ou-

lengths é null.

-ou-

lowerBounds é null.

ArgumentException

As matrizes lengths e lowerBounds não contêm o mesmo número de elementos.

-ou-

A matriz de comprimentos está vazia.

-ou-

arrayType não é um tipo de matriz.

-ou-

arrayType classificação não corresponde lengths comprimento.

ArgumentOutOfRangeException

Qualquer valor em lengths é menor que zero.

PlatformNotSupportedException

AOT nativo: qualquer valor em lowerBounds é diferente de zero.

Comentários

Quando o tipo de matriz está prontamente disponível, esse método deve ser preferencial em vez de CreateInstance(Type, Int32[], Int32[]), pois tem melhor desempenho e é amigável ao AOT.