Proprietà RecordCount (ADO)

  • Articolo

Indica il numero di record in un oggetto Recordset.

Valore restituito

Restituisce un valore Long che indica il numero di record nell'oggetto Recordset.

Osservazioni

Utilizzare la proprietà RecordCount per scoprire quanti record si trovano in un oggetto Recordset. La proprietà restituisce -1 quando ADO non è in grado di determinare il numero di record o se il provider o il tipo di cursore non supporta RecordCount. La lettura della proprietà RecordCount in un oggetto Recordset chiuso causa un errore.

Segnalibri o posizionamento approssimativo

Se l'oggetto Recordset supporta i segnalibri o il posizionamento approssimativo, questa proprietà restituisce il numero esatto di record nell'oggetto Recordset. Questa proprietà restituisce il numero esatto indipendentemente dal fatto che l'oggetto Recordset sia stato popolato completamente.

Al contrario, se l'oggetto Recordset non supporta i segnalibri o il posizionamento approssimativo, l'accesso a questa proprietà potrebbe comportare uno svuotamento significativo delle risorse. Lo svuotamento si verifica perché devono essere recuperati e conteggiati tutti i record per restituire un valore RecordCount accurato.

  • adBookmark è correlato ai segnalibri.
  • adApproxPosition si riferisce al posizionamento approssimativo.

Nota

Nelle versioni 2.8 e precedenti di ADO il provider SQLOLEDB recupera tutti i record quando viene usato un cursore lato server, nonostante restituisca True sia per Supports (adApproxPosition) che per Supports (adBookmark).

Il tipo di cursore dell'oggetto Recordset influisce sul fatto che sia possibile determinare il numero di record. La proprietà RecordCount restituirà -1 per un cursore forward-only, il conteggio effettivo per un cursore statico o keyset e -1 o il conteggio effettivo per un cursore dinamico, a seconda dell'origine dati.

Si applica a

Oggetto Recordset (ADO)

Vedere anche

Esempio delle proprietà Filter e RecordCount (VB)
Esempio delle proprietà Filter e RecordCount (VC++)
Proprietà AbsolutePosition (ADO)
Proprietà PageCount (ADO)