Partager via


CRecordset::SetRowsetCursorPosition

Déplace le curseur d'une ligne dans l'ensemble de lignes actuel.

void SetRowsetCursorPosition( 
   WORD wRow,
   WORD wLockType = SQL_LOCK_NO_CHANGE  
);

Paramètres

  • wRow
    La position de base 1 d'une ligne dans l'ensemble de lignes actuel. Cette valeur peut varier de 1 à la taille du jeu de lignes.

  • wLockType
    Évaluez indiquer comment verrouiller la ligne après sa actualisée. Pour plus d'informations, consultez les notes.

Notes

En implémentant l'extraction de lignes en bloc, les enregistrements sont récupérés par les jeux de lignes, où le premier enregistrement dans le jeu de lignes extrait est l'enregistrement courant. Afin de noter à un autre enregistrement dans le jeu de lignes l'enregistrement actif, appelez SetRowsetCursorPosition. Par exemple, vous pouvez combiner SetRowsetCursorPosition avec la fonction membre de GetFieldValue pour récupérer dynamiquement des données de tout enregistrement du recordset.

Pour utiliser SetRowsetCursorPosition, vous devez avoir implémenté l'extraction de lignes en bloc en spécifiant l'option d' CRecordset::useMultiRowFetch du paramètre d' dwOptions dans la fonction membre d' Ouvrez .

SetRowsetCursorPosition appelle la fonction API ODBC SQLSetPos. Le paramètre d' wLockType spécifie l'état de verrouillage de la ligne après SQLSetPos a exécuté. Le tableau suivant décrit les valeurs possibles pour wLockTypE.

wLockType

Description

SQL_LOCK_NO_CHANGE (valeur par défaut)

Le gestionnaire ou la source de données garantit que la ligne dans la même chose est verrouillée ou l'état déverrouillé tel qu'il était avant qu' SetRowsetCursorPosition a été appelé.

SQL_LOCK_EXCLUSIVE

Le gestionnaire ou la source de données verrouille la ligne exclusivement. Toutes les sources de données prennent en charge ce type de verrou.

SQL_LOCK_UNLOCK

Le gestionnaire ou la source de données déverrouille la ligne. Toutes les sources de données prennent en charge ce type de verrou.

Pour plus d'informations sur SQLSetPos, consultez Kit de développement logiciel Windows. Pour plus d'informations sur l'extraction de lignes en bloc, consultez l'article recordset : Extraction globale d'enregistrements (ODBC).

Configuration requise

Header: afxdb.h

Voir aussi

Référence

CRecordset, classe

Graphique de la hiérarchie

CRecordset::RefreshRowset

CRecordset::SetRowsetSize