Método GetRows (ADO)

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

Sintaxe

  
array = recordset.GetRows(Rows, Start, Fields )  

Valor retornado

Retorna um Variant cujo valor é uma matriz bidimensional.

Parâmetros

Linhas
Opcional. Um valor GetRowsOptionEnum que indica o número de registros a serem recuperados. O padrão é adGetRowsRest.

Iniciar
Opcional. Um valor String ou Variant que é avaliado como o indicador para o registro do qual a operação GetRows deve começar. Você também pode usar um valor BookmarkEnum.

Fields
Opcional. Um Variant que representa um único nome de campo, uma posição ordinal, uma matriz de nomes de campo ou números de posição ordinal. O ADO retorna apenas os dados nesses campos.

Comentários

Use o método GetRows para copiar registros de um Recordset em 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 recuperará 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 der suporte a indicadores, você poderá especificar em qual registro o método GetRows deve começar a recuperar dados passando o valor da propriedade Bookmark desse registro no argumento Start.

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

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

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo do método GetRows (VB)
Exemplo do método GetRows (VC++)