Méthode de Resynchronize

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

Syntaxe

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

Paramètres

AffectRecords
Optionnel. 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
Optionnel. Valeur ResyncEnum qui spécifie si les valeurs sous-jacentes sont remplacées. La valeur par défaut est adResyncAllValues.

Remarques

Recordset

Utilisez la méthode Resync pour resynchroniser les enregistrements dans l’ensemble d’enregistrements 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 non en lecture seule.

Contrairement à la méthode Requery , la méthode Resync ne réexécute pas 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, un enregistrement a été supprimé par un autre utilisateur), le fournisseur retourne des avertissements à la collection Errors et une erreur d’exécution se produit. Utilisez la propriété Filter (adFilterConflictingRecords) et la propriété Status pour localiser les enregistrements avec des conflits.

Si les propriétés dynamiques Table unique 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écute la commande donnée dans la propriété Resync Command uniquement sur la table nommée dans la propriété Table unique .

Domaines

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 Statusd’adFieldPendingUnknown ou adFieldPendingInsert, Resync n’a aucun effet. Pour les valeurs Statusd’adFieldPendingChange ou adFieldPendingDelete, Resync synchronise les valeurs de données pour les champs qui existent toujours à la source de données.

La resynchronisation ne modifie pas les valeurs d’état 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 d’état appropriée pour l’objet Field , par exemple adFieldDoesNotExist. Les valeurs d’état retournées peuvent être combinées logiquement dans la valeur de la propriété Status .

S’applique à

Fields, collection (ADO)

objet Recordset (ADO)

Voir aussi

Resync, méthode - Exemple (VB)
Resync, méthode - Exemple (VC++)
Clear, méthode (ADO)
UnderlyingValue, propriété