Resync-Methode (ADO)

Gilt für: Access 2013, Office 2013

Die Daten im aktuellen Recordset-Objekt oder in der Fields-Auflistung eines Record-Objekts werden anhand der zugrunde liegenden Datenbank aktualisiert.

Syntax

Recordset. ResyncAffectRecords, ResyncValues

Datensatz. Felder. ResyncResyncValues neu synchronisieren

Parameter

Parameter	Beschreibung
AffectRecords	Optional. Ein AffectEnum-Wert, durch den bestimmt wird, auf wie viele Datensätze sich die Resync-Methode auswirkt. Der Standardwert ist adAffectAll. Dieser Wert steht für die Resync-Methode der Fields-Auflistung eines Record-Objekts nicht zur Verfügung.
ResyncValues	Optional. Ein ResyncEnum-Wert, durch den angegeben wird, ob zugrunde liegende Werte überschrieben werden. Der Standardwert ist adResyncAllValues.

Hinweise

Recordset

Verwenden Sie die Resync-Methode zum erneuten Synchronisieren von Datensätzen im aktuellen Recordset mit der zugrunde liegenden Datenbank. Dies ist nützlich, wenn Sie einen statischen Cursor oder einen Vorwärtscursor verwenden, aber alle Änderungen in der zugrunde liegenden Datenbank sehen möchten.

Wenn Sie die CursorLocation-Eigenschaft auf adUseClient festlegen, steht Resync nur für nicht schreibgeschützte Recordset -Objekte zur Verfügung.

Im Gegensatz zur Requery-Methode wird durch die Resync -Methode der zugrunde liegende Befehl des Recordset -Objekts nicht erneut ausgeführt. Neue Datensätze in der zugrunde liegenden Datenbank werden nicht angezeigt.

Wenn der Versuch der erneuten Synchronisierung aufgrund eines Konflikts mit den zugrunde liegenden Daten fehlschlägt (z. B. weil ein Datensatz von einem anderen Benutzer gelöscht wurde), werden vom Anbieter Warnungen an die Errors-Auflistung zurückgegeben, und es tritt ein Laufzeitfehler auf. Verwenden Sie die Eigenschaften Filter (adFilterConflictingRecords) und Status, um Datensätze mit Konflikten zu suchen.

Wenn die dynamischen Eigenschaften Unique Table und Resync Command festgelegt sind und das Recordset das Ergebnis der Ausführung einer JOIN-Operation für mehrere Tabellen ist, wird von der Resync-Methode der Befehl in der Resync Command-Eigenschaft nur für die in der Unique Table-Eigenschaft genannte Tabelle ausgeführt.

Felder

Verwenden Sie die Resync-Methode zum erneuten Synchronisieren der Werte der Fields-Auflistung eines Record-Objekts mit der zugrunde liegenden Datenquelle. Auf die Count-Eigenschaft wirkt sich diese Methode nicht aus.

Wenn ResyncValues auf adResyncAllValues (Standardwert) festgelegt ist, werden die Eigenschaften UnderlyingValue, Value und OriginalValue der Field-Objekte in der Auflistung synchronisiert. Wenn ResyncValues auf adResyncUnderlyingValues festgelegt ist, wird nur die UnderlyingValue-Eigenschaft synchronisiert.

Der Wert der Status-Eigenschaft für die einzelnen Field-Objekte zum Zeitpunkt des Aufrufs wirkt sich auch auf das Verhalten von Resync aus. Auf Field-Objekte mit den Status-Werten adFieldPendingUnknown oder adFieldPendingInsert hat Resync keine Auswirkung. Für die Status -Werte adFieldPendingChange oder adFieldPendingDelete werden durch Resync die Datenwerte für in der Datenquelle noch vorhandene Felder synchronisiert.

Durch Resync werden Status-Werte von Field-Objekten nur geändert, wenn beim Aufrufen von Resync ein Fehler auftritt. Wenn z. B. das Feld nicht mehr vorhanden ist, wird vom Anbieter ein entsprechender Status-Wert für das Field-Objekt zurückgegeben, z. B. adFieldDoesNotExist. Zurückgegebene Status-Werte können innerhalb des Werts der Status-Eigenschaft logisch kombiniert werden.