Update-Methode

Speichert alle Änderungen, die Sie an der aktuellen Zeile eines Recordset-Objekts oder der Fields-Sammlung eines Record-Objekts vornehmen

Syntax

  
recordset.Update Fields, Values  
record.Fields.Update  

Parameter

Fields
Optional. Eine Variant, die einen einzelnen Namen darstellt, oder ein Variant-Array, das Namen oder Ordinalpositionen des Felds oder der Felder darstellt, die Sie ändern möchten

Werte
Optional. Eine Variant, die einen einzelnen Wert darstellt, oder ein Variant-Array, das Werte für das Feld oder die Felder im neuen Datensatz darstellt

Bemerkungen

Recordset

Verwenden Sie die Update-Methode, um alle Änderungen zu speichern, die Sie am aktuellen Datensatz eines Recordset-Objekts vornehmen, nachdem Sie die AddNew-Methode zuletzt aufgerufen oder alle Feldwerte in einem vorhandenen Datensatz geändert haben. Das Recordset-Objekt muss Updates unterstützen.

Führen Sie zum Festlegen von Feldwerten eine der folgenden Aktionen aus:

  • Weisen Sie der Eigenschaft Value eines Field-Objekts Werte zu, und rufen Sie die Update-Methode auf.

  • Übergeben Sie einen Feldnamen und einen Wert als Argumente mit dem Update-Aufruf.

  • Übergeben Sie ein Array von Feldnamen und ein Array von Werten mit dem Update-Aufruf.

Wenn Sie Arrays von Feldern und Werten verwenden, muss sich die gleiche Anzahl von Elementen in beiden Arrays befinden. Die Reihenfolge der Feldnamen muss außerdem mit der Reihenfolge der Feldwerte übereinstimmen. Wenn die Anzahl und Reihenfolge von Feldern und Werten nicht übereinstimmen, tritt ein Fehler auf.

Wenn das Recordset-Objekt Batchaktualisierungen 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 alle ausstehenden Änderungen am aktuellen Datensatz zu speichern, bevor die zusammengefassten Änderungen an den Anbieter übertragen werden.

Wenn Sie aus dem Datensatz wechseln, den Sie hinzufügen oder bearbeiten, bevor Sie die Update-Methode aufrufen, ruft ADO automatisch Update auf, um die Änderungen zu speichern. Sie müssen die CancelUpdate-Methode aufrufen, wenn Sie Änderungen am aktuellen Datensatz oder einen neu hinzugefügten Datensatz verwerfen möchten.

Der aktuelle Datensatz bleibt aktuell, nachdem Sie die Update-Methode aufgerufen haben.

Datensatz

Die Update-Methode finalisiert Ergänzungen, Löschungen und Updates für Felder in der Fields-Sammlung eines Record-Objekts.

Felder, die mit der Delete-Methode gelöscht wurden, werden beispielsweise sofort für das Löschen markiert, bleiben jedoch in der Sammlung. Die Update-Methode muss aufgerufen werden, um diese Felder vollständig aus der Sammlung des Anbieters zu löschen.

Gilt für

Weitere Informationen

Update- und CancelUpdate-Methode – Beispiel (VB)
Update- und CancelUpdate-Methode – Beispiel (VC++)
AddNew-Methode (ADO)
CancelUpdate-Methode (ADO)
EditMode-Eigenschaft
UpdateBatch-Methode