Resync, méthode (ADO)
S’applique à : Access 2013, Office 2013
Cette méthode actualise les données de l’objet Recordset actif ou la collection Fields d’un objet Record à partir de la base de données sous-jacente.
Syntaxe
Recordset. ResyncAffectRecords, ResyncValues
Enregistrement. Champs. Resynchroniser ResyncValues
Paramètres
| Paramètre | Description |
|---|---|
| AffectRecords | Optional. Valeur AffectEnum qui détermine le nombre d’enregistrements que la méthode Resync affectera. 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. La valeur ResyncEnum indique si les valeurs sous-jacentes sont remplacées. La valeur par défaut est adResyncAllValues. |
Remarques
Recordset
Faites appel à la méthode Resync pour resynchroniser des enregistrements de l'objet Recordset actif sur la base de données sous-jacente. Ceci est utile si vous utilisez un curseur statique ou avant uniquement, mais que vous voulez afficher les modifications apportées dans la base de données sous-jacente.
Si vous affectez à la propriété CursorLocation la valeur adUseClient, Resync n'est disponible que pour les objets Recordset en lecture-écriture.
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 à cause 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 les propriétés Filter (adFilterConflictingRecords) et Status pour identifier les enregistrements qui créent des conflits.
Si les propriétés dynamiques Unique Table et Resync Command sont définies et que l’objet Recordset obtenu provient de l’exécution d’une opération JOIN sur plusieurs tables, la méthode Resync exécute la commande fournie dans la propriété Resync Command uniquement au niveau de la table désignée dans la propriété Unique Table.
Champs
Faites appel à la méthode Resync pour resynchroniser les valeurs de la collection Fields d'un objet Record sur la source de données sous-jacente. La propriété Count n'est pas affectée par cette méthode.
Si ResyncValues a la valeur par défaut adResyncAllValues, les propriétés UnderlyingValue, Value et OriginalValue des objets Field de la collection sont synchronisés. Si ResyncValues a la valeur adResyncUnderlyingValues, seule la propriété UnderlyingValue est synchronisée.
The value of the Status property for each Field object at the time of the call also affects the behavior of Resync. For Field objects with Status values of adFieldPendingUnknown or adFieldPendingInsert, Resync has no effect. For Status values of adFieldPendingChange or adFieldPendingDelete, Resync synchronizes data values for fields that still exist at the data source.
Resync will not modify Status values of Field objects unless an error occurs when Resync is called. For example, if the field no longer exists, the provider will return an appropriate Status value for the Field object, such as adFieldDoesNotExist. Returned Status values may be logically combined within the value of the Status property.