Condividi tramite


Metodo GetRows (ADO)

Recupera più record di un oggetto Recordset in una matrice.

Sintassi

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

Valore restituito

Restituisce un valore Variant il cui valore è una matrice bidimensionale.

Parametri

prime righe
facoltativo. Valore GetRowsOptionEnum che indica il numero di record da recuperare. Il valore predefinito è adGetRowsRest.

Inizia
facoltativo. Valore String o Variant che restituisce il segnalibro per il record da cui deve iniziare l'operazione GetRows. È anche possibile usare un valore BookmarkEnum.

Fields
facoltativo. Valore Variant che rappresenta un singolo nome di campo o una posizione ordinale o una matrice di nomi di campo o numeri di posizione ordinali. ADO restituisce solo i dati in questi campi.

Osservazioni

Utilizzare il metodo GetRows per copiare i record da un oggetto Recordset in una matrice bidimensionale. Il primo indice inferiore identifica il campo e il secondo identifica il numero di record. La variabile array viene dimensionata automaticamente alla dimensione corretta quando il metodo GetRows restituisce i dati.

Se non si specifica un valore per l'argomento Rows, il metodo GetRows recupera automaticamente tutti i record nell'oggetto Recordset. Se si richiedono più record di quelli disponibili, GetRows restituisce solo il numero di record disponibili.

Se l'oggetto Recordset supporta i segnalibri, è possibile specificare in quale record il metodo GetRows deve iniziare a recuperare i dati passando il valore della proprietà Bookmark del record nell'argomento Start.

Se si desidera limitare i campi restituiti dalla chiamata GetRows, è possibile trasmettere un singolo nome/numero del campo o una matrice di nomi/numeri del campo nell'argomento Fields.

Dopo aver chiamato GetRows, il record non letto successivo diventa il record corrente oppure la proprietà EOF è impostata su True se non sono presenti più record.

Si applica a

Oggetto Recordset (ADO)

Vedere anche

Esempio del metodo GetRows (VB)
Esempio del metodo GetRows (VC++)