Update-Methode (ADO)
Gilt für: Access 2013, Office 2013
Speichert alle Änderungen, die Sie an der aktuellen Zeile eines Recordset-Objekts oder der Fields-Auflistung eines Record-Objekts vornehmen.
Syntax
recordset. Aktualisieren von Feldern, Werten
datensatz. Felder. Aktualisieren
Parameter
| Parameter | Beschreibung |
|---|---|
| Fields | Optional. Ein Variant-Wert , der einen einzelnen Namen darstellt, oder ein Variant-Array , das Namen oder Ordnungspositionen des Felds oder der Felder darstellt, die Sie ändern möchten. |
| Values | Optional. Ein Wert vom Datentyp Variant, der einen einzelnen Wert darstellt, oder ein Array vom Datentyp Variant, das Werte für das Feld oder die Felder im neuen Datensatz darstellt. |
Hinweise
Recordset
Verwenden Sie die Update-Methode, um Änderungen am aktuellen Datensatz eines Recordset-Objekts seit dem Aufrufen der AddNew-Methode oder seit dem Ändern von Feldwerten in einem vorhandenen Datensatz zu speichern. Das Recordset-Objekt muss Aktualisierungen unterstützen.
Führen Sie eine der folgenden Aktionen aus, um Feldwerte festzulegen:
Weisen Sie der Value-Eigenschaft eines Field-Objekts Werte zu, und rufen Sie die Update-Methode auf.
Übergeben Sie mithilfe des Update-Aufrufs einen Feldnamen und einen Wert als Argumente.
Übergeben Sie mithilfe des Update -Aufrufs ein Array von Feldnamen und ein Array von Werten.
Wenn Sie Arrays von Feldern und Werten verwenden, müssen in beiden Arrays gleich viele Elemente vorhanden sein. Die Reihenfolge der Feldnamen muss außerdem der Reihenfolge der Feldwerte entsprechen. Wenn die Anzahl und die 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 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.
Wenn Sie den Datensatz verlassen, den Sie hinzufügen oder bearbeiten, bevor Sie die Update -Methode aufrufen, ruft ADO zum Speichern der Änderungen automatisch Update auf. Sie müssen die CancelUpdate-Methode aufrufen, falls Sie Änderungen am aktuellen Datensatz abbrechen oder einen neu hinzugefügten Datensatz verwerfen möchten.
Der aktuelle Datensatz bleibt aktuell, nachdem Sie die Update-Methode aufgerufen haben.
Aufzeichnen
Mit der Update-Methode werden Lösch- und Aktualisierungsvorgänge für Felder in der Fields-Auflistung eines Record-Objekts abgeschlossen.
Beispielsweise werden mit der Delete -Methode gelöschte Felder sofort zum Löschen gekennzeichnet, verbleiben aber in der Auflistung. Die Update-Methode muss aufgerufen werden, damit diese Felder tatsächlich in der Auflistung des Anbieters gelöscht werden.