Classe Platform::ArrayPlatform::Array Class

Representa uma matriz unidimensional modificável, que pode ser recebida e transmitida pela interface binária de aplicativo (ABI).Represents a one-dimensional, modifiable array that can be received and passed across the application binary interface (ABI).

SintaxeSyntax

template <typename T>
private ref class Array<TArg, 1> :
    public WriteOnlyArray<TArg, 1>,
    public IBoxArray<TArg>

MembrosMembers

Platform::Array herda todos os métodos de Platform::WriteOnlyArray Class e implementa a propriedade Value da Platform::IBoxArray Interface.Platform::Array inherits all its methods from Platform::WriteOnlyArray Class and implements the Value property of the Platform::IBoxArray Interface.

Construtores públicosPublic Constructors

NomeName DescriçãoDescription
Construtores de matrizArray Constructors Inicializa uma matriz unidimensional e modificável de tipos especificados pelo parâmetro do modelo de classe, T.Initializes a one-dimensional, modifiable array of types specified by the class template parameter, T.

MétodosMethods

Consulte Platform::WriteOnlyArray Class.See Platform::WriteOnlyArray Class.

PropriedadesProperties

Array::ValueArray::Value Recupera um identificador para a matriz atual.Retrieves a handle to the current array.

ComentáriosRemarks

A classe da matriz é fechada e não pode ser herdada.The Array class is sealed and cannot be inherited.

O sistema de tipo de tempo de execução do Windows não suporta o conceito de matrizes denteadas e, portanto, você não pode passar um IVector < Platform:: array<T >> como um parâmetro de método ou valor de retorno.The Windows Runtime type system does not support the concept of jagged arrays and therefore you cannot pass an IVector<Platform::Array<T>> as a return value or method parameter. Para passar uma matriz denteada ou uma sequência de sequências através da ABI, use IVector<IVector<T>^>.To pass a jagged array or a sequence of sequences across the ABI, use IVector<IVector<T>^>.

Para obter mais informações sobre quando e como usar Platform:: array, consulte matriz e WriteOnlyArray.For more information about when and how to use Platform::Array, see Array and WriteOnlyArray.

O sistema de tipo de tempo de execução do Windows não suporta o conceito de matrizes denteadas e, portanto, você não pode passar um IVector < Platform:: array<T >> como um parâmetro de método ou valor de retorno.The Windows Runtime type system does not support the concept of jagged arrays and therefore you cannot pass an IVector<Platform::Array<T>> as a return value or method parameter. Para passar uma matriz denteada ou uma sequência de sequências através da ABI, use IVector<IVector<T>^>.To pass a jagged array or a sequence of sequences across the ABI, use IVector<IVector<T>^>.

Essa classe é definida no cabeçalho vccorlib.h, que é incluído automaticamente pelo compilador.This class is defined in the vccorlib.h header, which is automatically included by the compiler. Ele é visível no IntelliSense mas não no Pesquisador de objetos porque ele não é um tipo público definido em Platform. winmd.It is visible in IntelliSense but not in Object Browser because it is not a public type defined in platform.winmd.

RequisitosRequirements

Opção do compilador: /ZWCompiler option: /ZW

Construtores de matrizArray Constructors

Inicializa uma matriz unidimensional e modificável de tipos especificados pelo parâmetro do modelo de classe, T.Initializes a one-dimensional, modifiable array of types specified by the class template parameter, T.

SintaxeSyntax

Array(unsigned int size);
Array(T* data, unsigned int size);

ParâmetrosParameters

TT
Parâmetro de modelo de classe.Class template parameter.

sizesize
O número de elementos na matriz.The number of elements in the array.

datadata
Um ponteiro para uma matriz do tipo de dados T que é usado para inicializar esse objeto Array.A pointer to an array of data of type T that is used to initialize this Array object.

ComentáriosRemarks

Para obter mais informações sobre como criar instâncias de Platform:: array, consulte matriz e WriteOnlyArray.For more information about how to create instances of Platform::Array, see Array and WriteOnlyArray.

Método Array:: GetArray::get Method

Recupera uma referência ao elemento de matriz no local do índice especificado.Retrieves a reference to the array element at the specified index location.

SintaxeSyntax

T& get(unsigned int index)  const;

ParâmetrosParameters

indexindex
Um índice com base zero que identifica um elemento na matriz.A zero-based index that identifies an element in the array. O índice mínimo é 0 e o índice máximo é o valor especificado pela size parâmetro na construtor Array.The minimum index is 0 and the maximum index is the value specified by the size parameter in the Array constructor.

Valor de retornoReturn Value

O elemento de matriz especificado pelo parâmetro index.The array element specified by the index parameter.

Propriedade array:: ValueArray::Value Property

Recupera um identificador para a matriz atual.Retrieves a handle to the current array.

SintaxeSyntax

property Array^ Value;

Valor de retornoReturn Value

Um identificador para a matriz atual.A handle to the current array.

Consulte tambémSee Also

Namespace PlatformPlatform namespace
Matriz e WriteOnlyArrayArray and WriteOnlyArray