Resync, méthode

Actualise les données de l’objet Recordset actif ou de la collection Fields d’un objet Record à partir de la base de données sous-jacente.

Syntaxe

  
Recordset.Resync AffectRecords, ResyncValues Record.Fields.Resync ResyncValues  

Paramètres

AffectRecords
facultatif. Valeur AffectEnum qui détermine le nombre d’enregistrements affectés par la méthode Resync. La valeur par défaut est adAffectAll. Cette valeur n’est pas disponible avec la méthode Resync de la collection Fields d’un objet Record.

ResyncValues
facultatif. Valeur ResyncEnum qui spécifie si les valeurs sous-jacentes sont remplacées. La valeur par défaut est adResyncAllValues.

Notes

Ensemble d'enregistrements

Utilisez la méthode Resync pour resynchroniser les enregistrements dans l’objet Recordset actif avec la base de données sous-jacente. Cela est utile si vous utilisez un curseur statique ou avant uniquement, mais que vous souhaitez voir les modifications apportées à la base de données sous-jacente.

Si vous définissez la propriété CursorLocation sur adUseClient, Resync est disponible uniquement pour les objets Recordset qui ne sont pas en lecture seule.

Contrairement à la méthode Requery, la méthode Resync n’exécute pas à nouveau la commande sous-jacente de l’objet Recordset. Les nouveaux enregistrements de la base de données sous-jacente ne seront pas visibles.

Si la tentative de resynchronisation échoue en raison d’un conflit avec les données sous-jacentes (par exemple, si un enregistrement a été supprimé par un autre utilisateur), le fournisseur renvoie des avertissements à la collection Errors et une erreur d’exécution se produit. Utilisez la propriété Filter (adFilterAffectedRecords) et la propriété Status pour localiser les enregistrements en conflit.

Si les propriétés dynamiques Unique Table et Resync Command sont définies, et que l’objet Recordset est le résultat de l’exécution d’une opération JOIN sur plusieurs tables, la méthode Resync exécutera la commande indiquée dans la propriété Resync Command uniquement sur la table nommée dans la propriété Unique Table.

Champs

Utilisez la méthode Resync pour resynchroniser les valeurs de la collection Fields d’un objet Record avec la source de données sous-jacente. La propriété Count n’est pas affectée par cette méthode.

Si ResyncValues est défini sur adResyncAllValues (valeur par défaut), les propriétés UnderlyingValue, Value et OriginalValue des objets Field de la collection sont synchronisées. Si ResyncValues est défini sur adResyncUnderlyingValues, seule la propriété UnderlyingValue est synchronisée.

La valeur de la propriété Status pour chaque objet Field au moment de l’appel affecte également le comportement de Resync. Pour les objets Field qui ont des valeurs StatusadFieldPendingUnknown ou adFieldPendingInsert, Resync n’a aucun effet. Pour les valeurs StatusadFieldPendingChange ou adFieldPendingDelete, Resync synchronise les valeurs de données des champs qui existent toujours sur la source de données.

Resync ne modifie pas les valeurs Status des objets Field, sauf si une erreur se produit lors de l’appel de Resync. Par exemple, si le champ n’existe plus, le fournisseur retourne une valeur Status appropriée pour l’objet Field, par exemple adFieldDoesNotExist. Les valeurs Status retournées peuvent être combinées logiquement dans la valeur de la propriété Status.

S'applique à

Fields, collection (ADO)

Recordset, objet (ADO)

Voir aussi

Resync, exemple de méthode (VB)
Resync, exemple de méthode (VC++)
Clear, méthode (ADO)
UnderlyingValue, propriété