Recordset2.Update-Methode (DAO)
Gilt für: Access 2013, Office 2013
Syntax
Ausdruck . Update(UpdateType, Force)
Ausdruck Eine Variable, die ein Recordset2-Objekt darstellt.
Parameter
Name |
Erforderlich/optional |
Datentyp |
Beschreibung |
|---|---|---|---|
UpdateType |
Optional |
Long |
Eine UpdateTypeEnum -Konstante, die den Aktualisierungstyp so angibt, wie er in den Einstellungen angegeben ist (nur ODBCDirect-Arbeitsbereiche). |
Kraft |
Optional |
Boolean |
Ein Boolean-Wert, der angibt, ob die Änderungen in der Datenbank erzwungen werden sollen, unabhängig davon, ob die zugrunde liegenden Daten seit dem AddNew-, Delete- oder Edit-Aufruf von einem anderen Benutzer geändert wurden. Ist True festgelegt, werden die Änderungen erzwungen, und die von anderen Benutzern vorgenommenen Änderungen werden einfach überschrieben. Bei False (Standard) verursachen Änderungen, die andere Benutzer vorgenommen haben, während die Aktualisierung ausstand, ein Fehlschlagen der Aktualisierung für die Änderungen, bei denen Konflikte bestehen. Es tritt kein Fehler auf, aber die Eigenschaften BatchCollisionCount und BatchCollisions geben die Anzahl der Konflikte bzw. die von Konflikten betroffenen Zeilen an (nur ODBCDirect-Arbeitsbereiche). |
Bemerkungen
Verwenden Sie Update, um den aktuellen Datensatz und alle Änderungen, die Sie daran vorgenommen haben, zu speichern.
Wichtig
Änderungen an dem aktuellen Datensatz gehen in folgenden Fällen verloren:
- Sie verwenden die Edit- oder AddNew-Methode und wechseln dann zu einem anderen Datensatz, ohne zuvor Update zu verwenden.
- Sie verwenden Edit oder AddNew und dann erneut Edit oder AddNew, ohne zuvor Update zu verwenden.
- Sie legen die Bookmark -Eigenschaft auf einen anderen Datensatz fest.
- Sie schließen das Recordset, ohne zuvor Update zu verwenden.
- Sie brechen den Edit-Vorgang ab, indem Sie CancelUpdate verwenden.
Wenn Sie einen Datensatz bearbeiten möchten, verwenden Sie die Edit-Methode, um den Inhalt des aktuellen Datensatzes in den Kopierpuffer zu kopieren. Ohne vorheriges Anwenden von Edit tritt ein Fehler auf, sobald Sie Update verwenden oder versuchen, den Wert eines Felds zu ändern.
In einem ODBCDirect-Arbeitsbereich können Sie Batchaktualisierungen vornehmen, wenn die Cursor-Bibliothek dies unterstützt und das Recordset mit der Option der optimistischen Batchsperre geöffnet wurde.
Ist in einem Microsoft Access-Arbeitsbereich die LockEdits-Eigenschafteneinstellung eines Recordset-Objekts in einer Mehrbenutzerumgebung auf True festgelegt (pessimistisch gesperrt), bleibt der Datensatz ab dem Moment gesperrt, in dem Edit verwendet wird, bis zu dem Zeitpunkt, zu dem die Update-Methode ausgeführt oder die Bearbeitung abgebrochen wird. Wenn die LockEdits-Eigenschafteneinstellung auf False festgelegt ist (optimistisch gesperrt), wird der Datensatz gesperrt und mit dem vorab bearbeiteten Datensatz verglichen, bevor er in der Datenbank aktualisiert wird. Wurde der Datensatz nach dem Verwenden der Edit-Methode geändert, schlägt der Update-Vorgang fehl. Die mit einem Microsoft Access-Datenbankmodul verbundenen ODBC- und installierbaren ISAM-Datenbanken verwenden immer optimistische Sperren. Verwenden Sie erneut die Update-Methode, um den Update-Vorgang mit Ihren Änderungen fortzusetzen. Um den Datensatz wiederherzustellen, wie ihn der andere Benutzer geändert hat, aktualisieren Sie den aktuellen Datensatz mithilfe von Move 0.
Hinweis
[!HINWEIS] Es muss ein eindeutiger Index für den Datensatz in der zugrunde liegenden Datenquelle vorhanden sein, damit ein Datensatz hinzugefügt, bearbeitet oder gelöscht werden kann. Andernfalls tritt im Methodenaufruf AddNew, Delete oder Edit in einem Microsoft Access-Arbeitsbereich ein Fehler vom Typ "Berechtigung verweigert" auf, oder im Update-Aufruf in einem ODBCDirect-Arbeitsbereich tritt ein Fehler vom Typ "Ungültiges Argument" auf.