Recordset.UpdateOptions, propriété (DAO)

S’applique à : Access 2013, Office 2013

Syntaxe

expression . UpdateOptions

expression Variable représentant un objet Recordset.

Remarques

Lorsqu'une méthode Update en mode de traitement par lot est exécutée, DAO et la bibliothèque client de curseurs par lots créent une série d'instructions SQL UPDATE pour apporter les modifications nécessaires. Une clause SQL WHERE est créée pour chaque mise à jour afin d'isoler les enregistrements marqués comme étant modifiés par la propriété RecordStatus. Dans la mesure où certains serveurs distants utilisent des déclencheurs ou d'autres moyens pour appliquer l'intégrité référentielle, il est souvent essentiel de limiter les champs à mettre à jour aux seuls champs affectés par la modification.

Pour ce faire, affectez à la propriété UpdateOptions l'une des constantes dbCriteriaKey, dbCriteriaModValues, dbCriteriaAllCols ou dbCriteriaTimeStamp. De cette façon, seule la partie minimale indispensable du code de déclencheur est exécutée. Ainsi, l'opération de mise à jour est exécutée plus rapidement et est moins susceptible de contenir des erreurs.

Vous pouvez également concaténer l'une ou l'autre des constantes dbCriteriaDeleteInsert ou dbCriteriaUpdate pour déterminer s'il convient d'utiliser une série d'instructions SQL DELETE et INSERT ou une instruction SQL UPDATE pour chaque mise à jour lors du renvoi des modifications par lot au serveur. Dans le premier cas, deux opérations distinctes sont nécessaires pour mettre à jour l'enregistrement. Dans certains cas, en particulier lorsque le système distant met en œuvre des déclencheurs DELETE, INSERT et UPDATE, le choix de la valeur de la propriété UpdateOptions peut influer grandement sur les performances.

Si vous ne spécifiez pas de constantes, dbCriteriaUpdate et dbCriteriaKey seront utilisées.

Dans la mesure où les enregistrements récemment ajoutés génèrent toujours des instructions INSERT et les enregistrements supprimés toujours des instructions DELETE, cette propriété ne concerne que la façon dont la bibliothèque de curseurs met à jour les enregistrements modifiés.

Exemple

Cet exemple utilise les propriétés BatchSize et UpdateOptions pour contrôler des aspects des mises à jour par lot pour l'objet Recordset spécifié.

Sub BatchSizeX() 
 
 Dim wrkMain As Workspace 
 Dim conMain As Connection 
 Dim rstTemp As Recordset 
 
 Set wrkMain = CreateWorkspace("ODBCWorkspace", _ 
 "admin", "", dbUseODBC) 
 ' This DefaultCursorDriver setting is required for 
 ' batch updating. 
 wrkMain.DefaultCursorDriver = dbUseClientBatchCursor 
 
 ' Note: The DSN referenced below must be configured to 
 ' use Microsoft Windows NT Authentication Mode to 
 ' authorize user access to the Microsoft SQL Server. 
 Set conMain = wrkMain.OpenConnection("Publishers", _ 
 dbDriverNoPrompt, False, _ 
 "ODBC;DATABASE=pubs;DSN=Publishers") 
 
 ' The following locking argument is required for 
 ' batch updating. 
 Set rstTemp = conMain.OpenRecordset( _ 
 "SELECT * FROM roysched", dbOpenDynaset, 0, _ 
 dbOptimisticBatch) 
 
 With rstTemp 
 ' Increase the number of statements sent to the server 
 ' during a single batch update, thereby reducing the 
 ' number of times an update would have to access the 
 ' server. 
 .BatchSize = 25 
 
 ' Change the UpdateOptions property so that the WHERE 
 ' clause of any batched statements going to the server 
 ' will include any updated columns in addition to the 
 ' key column(s). Also, any modifications to records 
 ' will be made by deleting the original record 
 ' and adding a modified version rather than just 
 ' modifying the original record. 
 .UpdateOptions = dbCriteriaModValues + _ 
 dbCriteriaDeleteInsert 
 
 ' Engage in batch updating using the new settings 
 ' above. 
 ' ... 
 
 .Close 
 End With 
 
 conMain.Close 
 wrkMain.Close 
 
End Sub