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 do registro do qual a operação GetRows deve começar. Você também pode usar um valor BookmarkEnum.

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

Observações

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

Se você não especificar um valor para o argumento linhas, o método GetRows recuperará automaticamente todos os registros no objeto Recordset. Se você solicitar mais registros do que o disponível, 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 Iniciar.

Se você quiser restringir os campos que a chamada GetRows retorna, você 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

do objeto Recordset (ADO)

Consulte Também

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