Metodo CancelBatch (ADO)
Annulla un aggiornamento batch in sospeso.
Sintassi
recordset.CancelBatchAffectRecords
Parametri
AffectRecords
Opzionale. Valore di AffectEnum che indica il numero di record che influiscono sul metodo CancelBatch.
Osservazioni
Utilizzare il metodo CancelBatch per annullare gli aggiornamenti in sospeso in un recordset in modalità di aggiornamento batch. Se il recordset è in modalità di aggiornamento immediato, la chiamata CancelBatch senza adAffectCurrent genera un errore.
Se si modifica il record corrente o si aggiunge un nuovo record quando si chiama CancelBatch, ADO chiama prima il metodo cancelUpdate per annullare le modifiche memorizzate nella cache. Successivamente, tutte le modifiche in sospeso nell'recordset di vengono annullate.
Il record corrente può essere indeterminabile dopo una chiamata CancelBatch, soprattutto se si è in corso l'aggiunta di un nuovo record. Per questo motivo, è consigliabile impostare la posizione del record corrente su una posizione nota nel Recordset dopo la chiamata CancelBatch. Ad esempio, chiamare il metodo MoveFirst.
Se il tentativo di annullare gli aggiornamenti in sospeso non riesce a causa di un conflitto con i dati sottostanti (ad esempio, se un record è stato eliminato da un altro utente), il provider restituisce avvisi alla raccolta Errors ma non interrompe l'esecuzione del programma. Si verifica un errore di run-time solo se sono presenti conflitti in tutti i record richiesti. Utilizzare la proprietà Filter (adFilterAffectedRecords) e la proprietà Status per individuare i record con conflitti.
Si applica a
Vedere anche
esempio di metodi UpdateBatch e CancelBatch (VB)
esempio di metodi UpdateBatch e CancelBatch (VC++)
metodo Cancel (ADO)
metodo Cancel (RDS)
metodo CancelUpdate (ADO)
metodo CancelUpdate (RDS)
metodo clear (ADO)
proprietà LockType (ADO)
metodo UpdateBatch