Partager via

CRecordset::SetAbsolutePosition

  • Article

 

Positionne le recordset dans l'enregistrement correspondant au numéro d'enregistrement spécifiée.

Syntaxe

      void SetAbsolutePosition( 
   long nRows  
);

Paramètres

  • nRows
    La position ordinale de base 1 de l'enregistrement actuel dans le recordset.

Notes

SetAbsolutePosition déplace le pointeur d'enregistrement actif sur cette position ordinale.

Notes

Cette fonction membre est pas valide sur les recordsets en avant seulement.

Pour les recordsets ODBC, une configuration de position absolue de 1 fait référence au premier enregistrement du recordset ; une configuration de 0 fait référence à la position de (BOF) de début du fichier.

Vous pouvez également passer des valeurs négatives à SetAbsolutePosition.Dans ce cas la position du recordset est évaluée de la fin du recordset.Par exemple, SetAbsolutePosition( -1 ) déplace le pointeur d'enregistrement actif au dernier enregistrement du recordset.

Notes

La position absolue n'est pas destinée à être utilisée comme numéro d'enregistrement de remplacement.Les signets sont toujours la méthode recommandée pour conserver et de revenir à une position donnée, étant donné que la position d'un enregistrement est modifié en faisant précéder les enregistrements sont supprimées.De plus, vous ne pouvez pas être sûr qu'un enregistrement donné aura la même position absolue si le recordset est recréé de nouveau parce que l'ordre des enregistrements dans un recordset n'est pas garanti à moins qu'elle ne soit créée avec une instruction SQL à l'aide d'une clause de ORDER BY .

Pour plus d'informations sur la navigation et les signets de recordset, consultez les articles recordset : Défilement (ODBC) et recordset : Signets et positions absolues (ODBC).

Exceptions

Exception

Condition

Cette méthode peut lever des exceptions de type CDBException* et CMemoryException*.

Configuration requise

Header: afxdb.h

Voir aussi

CRecordset Class
Graphique hiérarchique
CRecordset::SetBookmark