Metodo Resync

  • Articolo

Aggiorna i dati nell'oggetto Recordset corrente o nella raccolta Fields di un oggetto Record dal database sottostante.

Sintassi

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

Parametri

AffectRecords
facoltativo. Valore AffectEnum che determina il numero di record su cui il metodo Resync avrà effetto. Il valore predefinito è adAffectAll. Questo valore non è disponibile con il metodo Resync della raccolta Fields di un oggetto Record.

ResyncValues
facoltativo. Valore ResyncEnum che specifica se i valori sottostanti vengono sovrascritti. Il valore predefinito è adResyncAllValues.

Osservazioni

recordset

Utilizzare il metodo Resync per risincronizzare i record nell'oggetto Recordset corrente con il database sottostante. Questa opzione è utile se si usa un cursore statico o forward-only, ma si desidera visualizzare eventuali modifiche nel database sottostante.

Se si imposta la proprietà CursorLocation su adUseClient, Resync è disponibile solo per gli oggetti Recordset non di sola lettura.

A differenza del metodo Requery, il metodo Resync non esegue nuovamente il comando sottostante dell'oggetto Recordset. I nuovi record nel database sottostante non saranno visibili.

Se il tentativo di risincronizzazione ha esito negativo a causa di un conflitto con i dati sottostanti (ad esempio, un record è stato eliminato da un altro utente), il provider restituisce avvisi alla raccolta Errors e si verifica un errore di run-time. Utilizzare la proprietà Filter (adFilterConflictingRecords) e la proprietà Status per individuare i record con conflitti.

Se vengono impostate le proprietà dinamiche Unique Table e Resync Command e l'oggetto Recordset è il risultato dell'esecuzione di un'operazione JOIN su più tabelle, il metodo Resync eseguirà il comando specificato nella proprietà Resync Command solo sulla tabella denominata nella proprietà Unique Table.

Campi

Utilizzare il metodo Resync per risincronizzare i valori della raccolta Fields di un oggetto Record con l'origine dati sottostante. La proprietà Count non è interessata da questo metodo.

Se ResyncValues è impostato su adResyncAllValues (valore predefinito), le proprietà UnderlyingValue, Value e OriginalValue degli oggetti Field nella raccolta vengono sincronizzate. Se ResyncValues è impostato su adResyncUnderlyingValues, viene sincronizzata solo la proprietà UnderlyingValue.

Il valore della proprietà Status per ogni oggetto Field al momento della chiamata influisce anche sul comportamento di Resync. Per gli oggetti Field con valori Status di adFieldPendingUnknown o adFieldPendingInsert, Resync non ha alcun effetto. Per i valori Status di adFieldPendingChange o adFieldPendingDelete, Resync sincronizza i valori dei dati per i campi ancora presenti nell'origine dati.

Resync non modificherà i valori Status degli oggetti Field a meno che non si verifichi un errore quando viene chiamato Resync. Ad esempio, se il campo non esiste più, il provider restituirà un valore Status appropriato per l'oggetto Field, ad esempio adFieldDoesNotExist. I valori Status restituiti possono essere combinati logicamente all'interno del valore della proprietà Status.

Si applica a

Raccolta Fields (ADO)

Oggetto Recordset (ADO)

Vedere anche

Esempio del metodo Resync (VB)
Esempio del metodo Resync (VC++)
Metodo Clear (ADO)
Proprietà UnderlyingValue