UpdateBatch-Methode (ADO)
Gilt für: Access 2013, Office 2013
Schreibt alle ausstehenden Batchaktualisierungen auf einen Datenträger.
Syntax
recordset. UpdateBatchAffectRecords
Parameter
| Parameter | Beschreibung |
|---|---|
| AffectRecords | Optional. Ein AffectEnum-Wert, der angibt, wie viele Datensätze von der UpdateBatch-Methode betroffen sind. |
Hinweise
Verwenden Sie die UpdateBatch -Methode, wenn Sie ein Recordset -Objekt im Batchaktualisierungsmodus ändern, um alle in einem Recordset -Objekt vorgenommenen Änderungen an die zugrunde liegende Datenbank zu übertragen.
Wenn das Recordset -Objekt die Batchaktualisierung unterstützt, können Sie mehrere Änderungen an mindestens einem Datensatz bis zum Aufrufen der UpdateBatch -Methode lokal speichern. Falls Sie den aktuellen Datensatz bearbeiten oder einen neuen Datensatz hinzufügen, wenn Sie die UpdateBatch-Methode aufrufen, ruft ADO automatisch die Update-Methode auf, um ausstehende Änderungen am aktuellen Datensatz zu speichern, bevor die Batchänderungen an den Anbieter übertragen werden. Sie sollten die Batchaktualisierung nur mit einem Keysetcursor oder einem statischen Cursor verwenden.
Hinweis
[!HINWEIS] Wenn Sie adAffectGroup als Wert für diesen Parameter angeben, wird ein Fehler erzeugt, falls im aktuellen Recordset -Objekt keine Datensätze angezeigt werden (z. B. ein Filter, mit dem keine Datensätze übereinstimmen).
Wenn beim Übertragen von Änderungen ein Fehler bei einem Datensatz oder allen Datensätzen aufgrund eines Konflikts mit den zugrunde liegenden Daten auftritt (z. B. wurde ein Datensatz bereits von einem anderen Benutzer gelöscht), gibt der Anbieter Warnungen an die Errors-Auflistung zurück, und ein Laufzeitfehler wird gemeldet. Verwenden Sie die Filter-Eigenschaft (adFilterAffectedRecords) und die Status-Eigenschaft, um nach Datensätzen mit Konflikten zu suchen.
Mit der CancelBatch-Methode brechen Sie alle ausstehenden Batchaktualisierungen ab.
Wenn die dynamischen Eigenschaften Unique Table und Update Resync festgelegt sind und das Recordset -Objekt das Ergebnis der Ausführung einer JOIN-Operation mit mehreren Tabellen ist, folgt je nach den Einstellungen der Update Resync -Eigenschaft auf die Ausführung der UpdateBatch -Methode implizit die Resync-Methode.
Die Reihenfolge, in der die einzelnen Aktualisierungen eines Batches in der Datenquelle ausgeführt werden, stimmt nicht unbedingt mit der Reihenfolge überein, in der sie im lokalen Recordset-Objekt ausgeführt wurden. Die Aktualisierungsreihenfolge ist vom Anbieter abhängig. Berücksichtigen Sie dies beim Codieren von miteinander verknüpften Aktualisierungen, wie z. B. Fremdschlüsseleinschränkungen für eine Einfügung oder Aktualisierung.