Synchronize21-Methode (RDS)
Synchronisieren Sie das angegebene Recordset mit der Datenbank, die durch die Verbindungszeichenfolge für die Verwendung mit ADO 2.1 angegeben ist.
Wichtig
Ab Windows 8 und Windows Server 2012 sind RDS-Serverkomponenten nicht mehr im Windows-Betriebssystem enthalten (weitere Informationen finden Sie in den jeweiligen Kompatibilitäts-Cookbooks zu Windows 8 und Windows Server 2012). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Service migriert werden.
Syntax
object.Synchronize21(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray)
Parameter
ConnectionString
Eine Zeichenfolge, die zum Herstellen einer Verbindung mit dem OLE DB-Anbieter verwendet wird, an den die Anforderung gesendet wird. Wenn ein Handler verwendet wird, kann der Handler die Verbindungszeichenfolge bearbeiten oder ersetzen.
HandlerString
Die Zeichenfolge identifiziert den Handler, der mit dieser Ausführung verwendet werden soll. Die Zeichenfolge enthält zwei Teile. Der erste Teil enthält den Namen (ProgID) des zu verwendenden Handlers. Der zweite Teil der Zeichenfolge enthält Argumente, die an den Handler übergeben werden sollen. Wie die Argumentezeichenfolge interpretiert wird, ist handlerspezifisch. Die beiden Teile werden durch die erste Instanz eines Kommas in der Zeichenfolge getrennt. Die Argumentezeichenfolge kann zusätzliche Kommas enthalten. Die Argumente sind optional.
lSynchronizeOptions
Eine Bitmaske mit Synchronisierungsoptionen.
1=UpdateTransact: Aktualisierungen an der Datenbank werden von einer Transaktion umschlossen. Die Transaktion wird abgebrochen, wenn eine der Aktualisierungen fehlschlägt.
2=RefreshWithUpdate: Bewirkt, dass Zeilenstatus zurückgegeben werden, wenn weder Refresh noch RefreshConflicts festgelegt ist.
4=Refresh: Das Recordset wird mit aktuellen Daten aus der Datenbank aktualisiert. Ausstehende Aktualisierungen werden nicht in die Datenbank gepusht. Wenn dieses Bit nicht festgelegt ist, wird das Recordset nicht aktualisiert, und alle ausstehenden Updates werden in die Datenbank gepusht.
8=RefreshConflicts Bei allen Zeilen mit ausstehenden Änderungen schlägt die Aktualisierung fehl. Die Zeilen, die nicht aktualisiert werden konnten, werden mit aktuellen Daten aus der Datenbank aktualisiert.
ppRecordset
Ein Zeiger auf einen Zeiger auf das Recordset, das synchronisiert werden soll.
pStatusArray
Eine Variante, die verwendet wird, um ein sicheres Array von Zeilenstatus für die Zeilen zurückzugeben, die von der Synchronisierung betroffen sind. Nicht festgelegt, wenn keine der folgenden Synchronisierungsoptionen festgelegt sind: RefreshWithUpdate, Refresh und RefreshConflicts.
Bemerkungen
Der HandlerString-Parameter kann Null sein. Was in diesem Fall geschieht, hängt davon ab, wie der RDS-Server konfiguriert ist. Die Handlerzeichenfolge „MSDFMAP.handler“ gibt an, dass der von Microsoft bereitgestellte Handler (Msdfmap.dll) verwendet werden soll. Die Handlerzeichenfolge „MASDFMAP.handler,sample.ini“ gibt an, dass der „Msdfmap.dll“-Handler verwendet und das Argument „sample.ini“ an den Handler übergeben werden soll. „Msdfmap.dll“ interpretiert dann das Argument als Anweisung zur Verwendung der „sample.ini“, um die Verbindungs- und Abfragezeichenfolgen zu überprüfen.
Hinweis
Die Synchronize21-Methode ist einfach eine Version der Synchronize-Methode (RDS). An den Stellen, wo Sie die Synchronize-Methode für die Kommunikation mit ADO 2.1 verwenden müssen, kann stattdessen die Synchronize21-Methode aufgerufen werden. Die Funktionen der Synchronize-Methode in ADO 2.5 und höher sind eine Obermenge der Funktionen, die für dieselbe Methode in ADO 2.1 bereitgestellt werden.