EditMode-Eigenschaft

Gibt den Bearbeitungsstatus des aktuellen Datensatzes an

Rückgabewert

Gibt einen EditModeEnum-Wert zurück

Bemerkungen

ADO verwaltet einen Bearbeitungspuffer, der dem aktuellen Datensatz zugeordnet ist. Diese Eigenschaft gibt an, ob Änderungen an diesem Puffer vorgenommen wurden oder ob ein neuer Datensatz erstellt wurde. Verwenden Sie die EditMode-Eigenschaft, um den Bearbeitungsstatus des aktuellen Datensatzes zu bestimmen. Sie können Tests für ausstehende Änderungen durchführen, wenn ein Bearbeitungsprozess unterbrochen wurde, und bestimmen, ob Sie die Update- oder die CancelUpdate-Methode verwenden müssen.

Im unmittelbaren Updatemodus wird die EditMode-Eigenschaft auf adEditNone zurückgesetzt, nachdem ein erfolgreicher Aufruf der Update-Methode durchgeführt wurde. Wenn ein Aufruf von Delete den Datensatz oder die Datensätze in der Datenquelle nicht erfolgreich löscht, z. B. aufgrund von Verletzungen der referentiellen Integrität, bleibt das Recordset im Bearbeitungsmodus (EditMode = adEditInProgress). Daher muss CancelUpdate aufgerufen werden, bevor der aktuelle Datensatz verschoben wird (z. B. mit Move, NextRecordset oder Close).

Im Batchupdatemodus, in dem der Anbieter mehrere Änderungen zwischenspeichert und diese nur dann in die zugrunde liegende Datenquelle schreibt, wenn Sie die UpdateBatch-Methode aufrufen, wird der Wert der EditMode-Eigenschaft geändert, wenn der erste Vorgang ausgeführt wird und nicht von einem Aufruf an die Update-Methode zurückgesetzt wird. Nachfolgende Vorgänge ändern den Wert der EditMode-Eigenschaft nicht, auch wenn verschiedene Vorgänge ausgeführt werden. Wenn der erste Vorgang z. B. einen neuen Datensatz hinzufügen soll und der zweite Änderungen an einem vorhandenen Datensatz vornimmt, zeigt die Eigenschaft von EditMode weiterhin adEditAdd an. Die EditMode-Eigenschaft wird erst nach dem Aufrufen von UpdateBatch auf adEditNone zurückgesetzt. Um festzustellen, welche Vorgänge ausgeführt wurden, legen Sie die Filter-Eigenschaft auf adFilterPending fest, damit nur Datensätze mit ausstehenden Änderungen sichtbar sind. Überprüfen Sie die Status-Eigenschaft jedes Datensatzes auf die an den Daten vorgenommenen Änderungen.

Hinweis

EditMode kann nur dann einen gültigen Wert zurückgeben, wenn ein aktueller Datensatz vorhanden ist. EditMode gibt einen Fehler zurück, wenn BOF oder EOF „true“ ist oder der aktuelle Datensatz gelöscht wurde.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

Beispiel für die Eigenschaften „CursorType“, „LockType“ und „EditMode“ (VB)
Beispiel für die Eigenschaften „CursorType“, „LockType“ und „EditMode“ (VC++)
AddNew-Methode (ADO)
Delete-Methode (ADO-Recordset)
CancelUpdate-Methode (ADO)
Update-Methode