AddNew-Methode (ADO)
Gilt für: Access 2013, Office 2013
Es wird ein neuer Datensatz für ein aktualisierbares Recordset-Objekt erstellt.
Syntax
recordset. AddNew FieldList, Values
Parameter
| Parameter | Beschreibung |
|---|---|
| recordset | Ein Recordset -Objekt. |
| FieldList | Optional. Ein einzelner Name oder ein Array aus Namen oder Positionen der Felder im neuen Datensatz. |
| Werte | Optional. Ein einzelner Wert oder ein Array aus Werten für die Felder im neuen Datensatz. Wenn Fieldlist ein Array ist, muss Values ebenfalls ein Array mit der gleichen Anzahl an Mitgliedern sein, andernfalls tritt ein Fehler auf. Die Reihenfolge der Feldnamen muss mit der Reihenfolge der Feldwerte in den einzelnen Arrays übereinstimmen. |
Hinweise
Verwenden Sie die AddNew -Methode zum Erstellen und Initialisieren eines neuen Datensatzes. Verwenden Sie die Supports-Methode mit adAddNew (ein CursorOptionEnum-Wert), um zu überprüfen, ob Sie dem aktuellen Recordset -Objekt Datensätze hinzufügen können.
After you call the AddNew method, the new record becomes the current record and remains current after you call the Update method. Since the new record is appended to the Recordset, a call to MoveNext following the Update will move past the end of the Recordset, making EOF True. If the Recordset object does not support bookmarks, you may not be able to access the new record once you move to another record. Depending on your cursor type, you may need to call the Requery method to make the new record accessible.
Wenn Sie AddNew beim Bearbeiten des aktuellen Datensatzes oder beim Hinzufügen eines neuen Datensatzes aufrufen, wird von ADO die Update -Methode aufgerufen, um alle Änderungen zu speichern und dann den neuen Datensatz zu erstellen.
Das Verhalten der AddNew-Methode hängt vom Aktualisierungsmodus des Recordset-Objekts ab und davon, ob Sie die Argumente Fieldlist und Values übergeben.
Im unmittelbaren Aktualisierungsmodus (in dem Änderungen durch den Anbieter in die zugrunde liegende Datenquelle geschrieben werden, wenn Sie die Update-Methode aufrufen) wird durch Aufrufen der AddNew-Methode ohne Argumente die EditMode-Eigenschaft auf adEditAdd festgelegt (ein EditModeEnum-Wert). Alle Änderungen von Feldwerten werden vom Anbieter lokal zwischengespeichert. Durch Aufrufen der Update-Methode wird der neue Datensatz in der Datenbank bereitgestellt und die EditMode-Eigenschaft auf adEditNone festgelegt (ein EditModeEnum-Wert). Wenn Sie die Argumente Fieldlist und Valuesübergeben, wird der neue Datensatz von ADO sofort in der Datenbank bereitgestellt (ein Aufruf von Update ist nicht notwendig); der Wert der EditMode-Eigenschaft wird nicht geändert (adEditNone).
Im Batchaktualisierungsmodus (in dem der Anbieter mehrere Änderungen zwischenspeichert und diese nur dann in die zugrunde liegende Datenquelle schreibt, wenn Sie die UpdateBatch-Methode aufrufen), legt das Aufrufen der AddNew-Methode ohne Argumente die EditMode-Eigenschaft auf adEditAdd fest. Alle Änderungen von Feldwerten werden vom Anbieter lokal zwischengespeichert. Beim Aufrufen der Update-Methode wird der neue Datensatz dem aktuellen Recordset hinzugefügt und die EditMode-Eigenschaft auf adEditNone zurückgesetzt. Der Anbieter stellt die Änderungen jedoch erst in der zugrunde liegenden Datenbank bereit, wenn Sie die UpdateBatch-Methode aufrufen. Wenn Sie die Argumente Fieldlist und Values übergeben, sendet ADO den neuen Datensatz zur Speicherung in einem Cache an den Anbieter. Sie müssen die UpdateBatch-Methode aufrufen, um den neuen Datensatz in der zugrunde liegenden Datenbank zu veröffentlichen.