Exécution d’instructions de mise à jour et de suppression positionnées

Important

Cette fonctionnalité sera supprimée dans une version future de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Microsoft recommande d’utiliser la fonctionnalité de curseur du pilote.

Une fois qu’une application a extrait un bloc de données avec SQLFetchScroll, elle peut mettre à jour ou supprimer les données dans le bloc. Pour exécuter une mise à jour ou une suppression positionnée, l’application :

1. Appelle SQLSetPos pour positionner le curseur sur la ligne à mettre à jour ou supprimer.

2. Construit une instruction de mise à jour ou de suppression positionnée avec la syntaxe suivante :

   UPDATE table-name

   SET column-identifier = {expression | NULL}

   [, column-identifier = {expression | NULL}]

   WHERE CURRENT OF cursor-name

   DELETE FROM table-name WHERE CURRENT OF cursor-name

   Le moyen le plus simple de construire la clause SET dans une instruction de mise à jour positionnée consiste à utiliser des marqueurs de paramètres pour chaque colonne à mettre à jour et à utiliser SQLBindParameter pour lier ces éléments aux mémoires tampons d’ensemble de lignes pour que la ligne soit mise à jour. Dans ce cas, le type de données C du paramètre est identique au type de données C de la mémoire tampon de l’ensemble de lignes.

3. Met à jour les mémoires tampons de l’ensemble de lignes pour la ligne active si elle exécute une instruction de mise à jour positionnée. Après avoir exécuté une instruction de mise à jour positionnée, la bibliothèque de curseurs copie les valeurs de chaque colonne de la ligne active dans son cache.

   Attention

   Si l’application ne met pas correctement à jour les mémoires tampons de l’ensemble de lignes avant d’exécuter une instruction de mise à jour positionnée, les données du cache sont incorrectes une fois l’instruction exécutée.

4. Exécute l’instruction de mise à jour ou de suppression positionnée à l’aide d’une instruction différente de celle associée au curseur.

   Attention

   La clause WHERE construite par la bibliothèque de curseurs pour identifier la ligne active peut échouer pour identifier les lignes, identifier une autre ligne ou identifier plusieurs lignes. Pour plus d’informations, consultez Construction d’instructions recherchées.

Toutes les instructions de mise à jour et de suppression positionnées nécessitent un nom de curseur. Pour spécifier le nom du curseur, une application appelle SQLSetCursorName avant l’ouverture du curseur. Pour utiliser le nom du curseur généré par le pilote, une application appelle SQLGetCursorName une fois le curseur ouvert.

Une fois la bibliothèque de curseurs exécutée une instruction de mise à jour ou de suppression positionnée, le tableau d’état, les mémoires tampons d’ensemble de lignes et le cache gérés par la bibliothèque de curseurs contiennent les valeurs indiquées dans le tableau suivant.

Instruction utilisée	Valeur dans le tableau d’état de ligne	Valeurs dans mémoires tampons d'ensemble de lignes	Valeurs dans mémoires tampons de cache
Mise à jour positionnée	SQL_ROW_UPDATED	Nouvelles valeurs[1]	Nouvelles valeurs[1]
Suppression positionnée	SQL_ROW_DELETED	Anciennes valeurs	Anciennes valeurs

[1] L’application doit mettre à jour les valeurs dans les mémoires tampons de l’ensemble de lignes avant d’exécuter l’instruction de mise à jour positionnée ; après l’exécution de l’instruction de mise à jour positionnée, la bibliothèque de curseurs copie les valeurs dans les mémoires tampons de l’ensemble de lignes dans son cache.