Resync-Methode

  • Artikel

Aktualisiert die Daten in dem aktuellen Recordset-Objekt oder in der Fields-Auflistung eines Record-Objekts aus der zugrunde liegenden Datenbank.

Syntax

  
Recordset.Resync AffectRecords, ResyncValues Record.Fields.Resync ResyncValues

Parameter

AffectRecords
Optional. Ein AffectEnum-Wert, der bestimmt, wie viele Datensätze von der Resync-Methode betroffen sein werden. Der Standardwert ist adAffectAll. Dieser Wert ist mit der Methode Resync der Fields-Sammlung eines Record-Objekts nicht verfügbar.

ResyncValues
Optional. Ein ResyncEnum-Wert, der festlegt, ob die zugrunde liegenden Werte überschrieben werden. Der Standardwert ist adResyncAllValues.

Bemerkungen

Recordset

Verwenden Sie die Methode Resync, um Datensätze im aktuellen Recordset mit der darunter liegenden Datenbank neu zu synchronisieren. Dies ist nützlich, wenn Sie entweder mit einem statischen oder einem reinen Vorwärtscursor arbeiten, aber alle Änderungen in der zugrunde liegenden Datenbank sehen möchten.

Wenn Sie die Eigenschaft CursorLocation auf adUseClient setzen, ist Resync nur für nicht schreibgeschützte Recordset-Objekte verfügbar.

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

Sollte der Versuch einer erneuten Synchronisierung aufgrund eines Konflikts mit den zugrundeliegenden Daten fehlschlagen (z.B. weil ein Datensatz von einem anderen Benutzer gelöscht wurde), gibt der Anbieter Warnungen an die Sammlung Errors zurück und es tritt ein Laufzeitfehler auf. Verwenden Sie die Eigenschaft Filter (adFilterConflictingRecords) und die Eigenschaft Status, um Datensätze mit Konflikten zu finden.

Wenn die dynamischen Eigenschaften Unique Table und Resync Command gesetzt sind und das Recordset das Ergebnis einer JOIN-Operation auf mehrere Tabellen ist, dann führt die Methode Resync den in der Eigenschaft Resync Command angegebenen Befehl nur auf der in der Eigenschaft Unique Table genannten Tabelle aus.

Felder

Nutzen Sie die Methode Resync, um die Werte der Fields-Sammlung eines Record-Objekts mit der zugrunde liegenden Datenquelle zu synchronisieren. Die Eigenschaft Count wird von dieser Methode nicht beeinflusst.

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

Der Wert der Eigenschaft Status für jedes Field-Objekt zum Zeitpunkt des Aufrufs beeinflusst auch das Verhalten von Resync. Bei Feldobjekten, die den StatusadFieldPendingUnknown oder adFieldPendingInsert haben, hat Resync keine Wirkung. Bei Statuswerten von adFieldPendingChange oder adFieldPendingDelete synchronisiert Resync die Datenwerte für Felder, die noch in der Datenquelle vorhanden sind.

Resync ändert keineStatuswerte von Field-Objekten, es sei denn, beim Aufruf von Resync tritt ein Fehler auf. Wenn beispielsweise das Feld nicht mehr existiert, gibt der Anbieter einen entsprechenden Statuswert für das Field-Objekt zurück, z.B. adFieldDoesNotExist. Zurückgegebene Statuswerte können logisch mit dem Wert der Eigenschaft Status kombiniert werden.

Gilt für

Fields-Collection (ADO)

Recordset-Objekt (ADO)

Weitere Informationen

Resync-Methode – Beispiel (VB)
Resync-Methode – Beispiel (VC++)
Clear-Methode (ADO)
UnderlyingValue-Eigenschaft