_Table.GetArray(Int32) Método

public:
 System::Object ^ GetArray(int MaxRows);

public object GetArray (int MaxRows);

Public Function GetArray (MaxRows As Integer) As Object

Parâmetros

Retornos

Um valor object que é uma matriz bidimensional que representa um conjunto de valores de linha e coluna da Tabela. A matriz é baseada em zero; um índice de matriz (i, j) indexa na coluna i-th e na linha j-th na matriz. As colunas na matriz correspondem a colunas na Tabela e as linhas na matriz correspondem a linhas na Tabela. O número de linhas na matriz retornada é o valor menor e MaxRows o número real de linhas na Tabela.

Comentários

O método GetArray oferece um meio conceitualmente simples para obter valores de uma Tabela copiando todos ou parte dos dados na Tabela (com base na linha atual) para uma matriz e indexação na matriz.

GetArray sempre começa na linha atual da Tabela. Ele retorna uma matriz com MaxRows número de linhas se houver pelo menos MaxRows um número de linhas na Tabela começando na posição atual. Se MaxRows não for maior que o número total de linhas na Tabela e houver menos de MaxRows um número de elementos na Tabela começando na linha atual, ele retornará uma matriz que contém apenas as linhas restantes na Tabela. Se GetArray for chamado e não houver linhas restantes, GetArray retornará uma matriz vazia sem elementos.

Depois de obter as linhas apropriadas da Tabela e antes de retornar, GetArray sempre reposiciona a linha atual para a próxima linha na Tabela, se houver uma próxima linha. GetArray(n) opera como se GetNextRow() fosse chamado n vezes.

Os valores nas colunas são mapeados para colunas na Tabela e, portanto, são determinados pelo formato do nome da propriedade usado para a coluna. Para obter mais informações, confira Fatores que afetam a representação do valor da propriedade nas classes Tabela e Exibição

Aplica-se a