Update-Methode
Speichert alle Änderungen, die Sie an der aktuellen Zeile eines Recordset- -Objekts oder der Fields -Auflistung eines Record -Objekts vornehmen.
Syntax
recordset.Update Fields, Values
record.Fields.Update
Parameter
Felder
Wahlfrei. Eine Variant-, die einen einzelnen Namen darstellt, oder ein Variant Array, das Namen oder Ordnungspositionen des Felds oder der Felder darstellt, die Sie ändern möchten.
Werte
Wahlfrei. Ein Variant-, das 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, da die AddNew--Methode aufgerufen wird, oder seit dem Ändern von Feldwerten in einem vorhandenen Datensatz. Das Recordset-Objekt muss Updates unterstützen.
Führen Sie zum Festlegen von Feldwerten eine der folgenden Aktionen aus:
Weisen Sie einem Field-Objekt Value-Eigenschaft Werte zu, und rufen Sie die Update-Methode auf.
Übergeben Sie einen Feldnamen und einen Wert als Argumente mit dem aufruf Update.
Übergeben Sie ein Array von Feldnamen und ein Wertearray mit dem aufruf Update.
Wenn Sie Arrays von Feldern und Werten verwenden, muss in beiden Arrays eine gleiche Anzahl von Elementen vorhanden sein. Außerdem muss die Reihenfolge der Feldnamen 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 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.
Wenn Sie vor dem Aufrufen der Update-Methode aus dem Datensatz wechseln, den Sie hinzufügen oder bearbeiten, ruft ADO automatisch Update auf, um die Änderungen zu speichern. Sie müssen die CancelUpdate-Methode aufrufen, wenn Sie änderungen am aktuellen Datensatz abbrechen oder einen neu hinzugefügten Datensatz verwerfen möchten.
Der aktuelle Datensatz bleibt aktuell, nachdem Sie die methode Update aufgerufen haben.
Aufzeichnung
Die Update Methode schließt Ergänzungen, Löschungen und Aktualisierungen von Feldern in der Fields Auflistung eines Record-Objekts ab.
Beispielsweise werden felder, die mit der Delete-Methode gelöscht wurden, sofort zum Löschen markiert, aber in der Auflistung verbleiben. Die methode Update muss aufgerufen werden, um diese Felder tatsächlich aus der Auflistung des Anbieters zu löschen.
Gilt für
Siehe auch
Update- und CancelUpdate-Methode (Beispiel) (VB)
Update- und CancelUpdate-Methode (Beispiel) (VC++)
AddNew-Methode (ADO)
CancelUpdate-Methode (ADO)
EditMode-Eigenschaft
UpdateBatch-Methode