UpdateBatch-Methode
Schreibt alle ausstehenden Batchaktualisierungen auf den Datenträger.
Syntax
recordset.UpdateBatch AffectRecords, PreserveStatus
Parameter
AffectRecords-
Wahlfrei. Ein AffectEnum Wert, der angibt, wie viele Datensätze die UpdateBatch-Methode beeinflussen.
PreserveStatus-
Wahlfrei. Ein boolescher Wert, der angibt, ob lokale Änderungen, wie durch die eigenschaft Status angegeben, übernommen werden sollen. Wenn dieser Wert auf Truefestgelegt ist, bleibt die Status- eigenschaft jedes Datensatzes nach Abschluss der Aktualisierung unverändert.
Bemerkungen
Verwenden Sie die UpdateBatch--Methode, wenn Sie ein Recordset-Objekt im Batchaktualisierungsmodus ändern, um alle Änderungen, die in einem Recordset-Objekt vorgenommen wurden, an die zugrunde liegende Datenbank zu übertragen.
Wenn das Recordset Objekt die Batchaktualisierung unterstützt, können Sie mehrere Änderungen an einem oder mehreren Datensätzen lokal zwischenspeichern, bis Sie die UpdateBatch--Methode aufrufen. Wenn 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 Keyset- oder statischen Cursor verwenden.
Anmerkung
Wenn Sie adAffectGroup- als Wert für diesen Parameter angeben, tritt ein Fehler auf, wenn keine sichtbaren Datensätze im aktuellen Recordset- vorhanden sind (z. B. ein Filter, für den keine Datensätze übereinstimmen).
Wenn der Versuch, Änderungen zu übertragen, fehlschlägt oder alle Datensätze aufgrund eines Konflikts mit den zugrunde liegenden Daten (z. B. wurde ein Datensatz bereits von einem anderen Benutzer gelöscht), gibt der Anbieter Warnungen an die Errors Collection zurück und ein Laufzeitfehler tritt auf. Verwenden Sie die eigenschaft Filter (adFilterAffectedRecords) und die eigenschaft Status, um Datensätze mit Konflikten zu suchen.
Um alle ausstehenden Batchaktualisierungen abzubrechen, verwenden Sie die CancelBatch--Methode.
Wenn die Unique Table und Update Resync dynamische Eigenschaften festgelegt sind und das Recordset- das Ergebnis der Ausführung eines JOIN-Vorgangs für mehrere Tabellen ist, wird die Ausführung der UpdateBatch-Methode implizit gefolgt von der Resync--Methode, abhängig von den Einstellungen der Update Resync-Eigenschaft.
Die Reihenfolge, in der die einzelnen Aktualisierungen eines Batches für die Datenquelle ausgeführt werden, entspricht nicht unbedingt der Reihenfolge, in der sie für das lokale Recordset-ausgeführt wurden. Die Updatereihenfolge ist vom Anbieter abhängig. Berücksichtigen Sie dies beim Codieren von Updates, die miteinander zusammenhängen, z. B. Fremdschlüsseleinschränkungen für ein Einfügen oder Aktualisieren.
Gilt für
Siehe auch
UpdateBatch- und CancelBatch-Methode (Vb-Beispiel)
UpdateBatch- und CancelBatch-Methode (Beispiel) (VC++)
CancelBatch-Methode (ADO)
Clear-Methode (ADO)
LockType-Eigenschaft (ADO)
Update-Methode