Método GetRows (ADO)

Aplica-se ao: Access 2013, Office 2013

Recupera vários registros de um objeto Recordset para dentro de uma matriz.

Sintaxe

Matriz = conjunto de registros. GetRows(Linhas, Início, Campos )

Valor de retorno

Retorna uma Variant cujo valor é uma matriz bidimensional.

Parâmetros

Parâmetro	Descrição
Linhas	Opcional. Um valor GetRowsOptionEnum que indica o número de registros a serem recuperados. O padrão é adGetRowsRest.
Start	Opcional. Um valor String ou Variant que é avaliado para o indicador de um registro a partir do qual a operação GetRows deve começar. Também é possível utilizar um valor BookmarkEnum.
Fields	Opcional. Uma Variant que representa um único nome de campo ou posição ordinal, ou uma matriz de nomes de campos ou números de posição ordinal. O ADO retorna apenas os dados nesses campos.

Comentários

Utilize o método GetRows para copiar registros de um Recordset para uma matriz bidimensional. O primeiro subscrito identifica o campo e o segundo identifica o número do registro. A variável array é dimensionada automaticamente para o tamanho correto quando o método GetRows retorna os dados.

Se você não especificar um valor para o argumento Rows, o método GetRows recupera automaticamente todos os registros no objeto Recordset. Se você solicitar mais registros do que os disponíveis, GetRows retornará apenas o número de registros disponíveis.

Se o objeto Recordset suportar indicadores, será possível especificar em qual registro o método GetRows deve começar a recuperar dados, passando-se o valor da propriedade Bookmark desse registro no argumento Start.

Se você deseja restringir os campos que a chamada a GetRows retorna, poderá passar um único número/nome de campo ou uma matriz de números/nomes de campo no argumento Fields.

Depois de chamar GetRows, o próximo registro não-lido tornar-se-a o registro atual, ou a propriedade EOF será definida como True se não houver mais registros.