Partager via


CRecordset::RefreshRowset

Met à jour les données et le mode d'une ligne dans l'ensemble de lignes actuel.

void RefreshRowset( 
   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 zéro à la taille du jeu de lignes.

  • wLockType
    Une valeur indiquant comment verrouiller la ligne après sa actualisée. Pour plus d'informations, consultez les notes.

Notes

Si vous passez une valeur zéro pour wRow, chaque ligne dans l'ensemble de lignes est actualisée.

Pour utiliser RefreshRowset, vous devez avoir implémenté l'extraction de lignes en bloc en spécifiant l'option de CRecordset::useMulitRowFetch dans la fonction membre d' Ouvrez .

RefreshRowset 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' RefreshRowset 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::SetRowsetCursorPosition

CRecordset::SetRowsetSize