Synchronize, méthode (RDS)
Synchronisez le jeu d’enregistrements donné avec la base de données spécifiée par la chaîne de connexion à utiliser dans ADO 2.5 et versions ultérieures.
Important
À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir Windows 8 et livre de recettes de compatibilité Windows Server 2012 pour plus de détails). Les composants clients RDS seront supprimés dans une prochaine version 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é. Les applications qui utilisent RDS doivent migrer vers wcf Data Service .
Syntaxe
object.Synchronize(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray, [lcid As Long], [pInformation)
Paramètres
connectionString
Chaîne utilisée pour se connecter au fournisseur OLE DB où la requête sera envoyée. Si un gestionnaire est utilisé, le gestionnaire peut modifier ou remplacer la chaîne de connexion.
HandlerString
La chaîne identifie le gestionnaire à utiliser avec cette exécution. La chaîne contient deux parties. La première partie contient le nom (ProgID) du gestionnaire à utiliser. La deuxième partie de la chaîne contient des arguments à passer au gestionnaire. La façon dont la chaîne d’arguments est interprétée est spécifique au gestionnaire. Les deux parties sont séparées par la première instance d’une virgule dans la chaîne (bien que la chaîne d’arguments contienne des virgules supplémentaires). Les arguments sont facultatifs.
lSynchronizeOptions
Masque de bits des options de synchronisation.
1=UpdateTransact Mises à jour de la base de données sont encapsulées dans une transaction. La transaction est abandonnée si l’une des mises à jour échoue.
2=RefreshWithUpdate Provoque le retour des états de ligne lorsque ni Actualiser ni RefreshConflicts est défini.
4=Actualiser Le jeu d’enregistrements est actualisé avec les données actuelles de la base de données. Les mises à jour en attente ne sont pas envoyées à la base de données. Si ce bit n’est pas défini, le jeu d’enregistrements n’est pas actualisé et toutes les mises à jour en attente sont envoyées à la base de données.
8=RefreshConflicts Toutes les lignes avec des modifications en attente ne parviennent pas à être mises à jour. Les lignes qui n’ont pas pu être mises à jour sont actualisées avec les données actuelles de la base de données.
ppRecordset
Pointeur vers le jeu d’enregistrements à synchroniser.
pStatusArray
Variante utilisée pour retourner un tableau sécurisé d’états de ligne pour les lignes affectées par la synchronisation. Non défini si aucune des options de synchronisation suivantes n’est définie : RefreshWithUpdate, Actualiser et RefreshConflicts.
lcid
LCID utilisé pour générer les erreurs retournées dans pInformation .
pInformation
Pointeur vers une erreur d’informations retournée par Exécuter. Si la valeur EST NULL, aucune information d’erreur n’est retournée.
Remarques
Le paramètre HandlerString peut être null. Ce qui se passe dans ce cas dépend de la configuration du serveur RDS. Une chaîne de gestionnaire de « MSDFMAP.handler » indique que le gestionnaire fourni par Microsoft (Msdfmap.dll) doit être utilisé. Une chaîne de gestionnaire « MASDFMAP.handler,sample.ini» indique que le gestionnaire Msdfmap.dll doit être utilisé et que l’argument «sample.ini» doit être passé au gestionnaire. Msdfmap.dll interprétera ensuite l’argument comme une direction pour utiliser les sample.ini pour vérifier la connexion et les chaînes de requête.