Metodo CancelBatch (ADO)

Annulla un aggiornamento batch in sospeso.

Sintassi

  
recordset.CancelBatchAffectRecords  

Parametri

AffectRecords
facoltativo. Valore AffectEnum che indica il numero di record che verranno influenzati dal metodo CancelBatch.

Commenti

Usare il metodo CancelBatch per annullare eventuali aggiornamenti in sospeso in un oggetto Recordset in modalità di aggiornamento batch. Se il recordset è in modalità di aggiornamento immediato, la chiamata di CancelBatch senza adAffectCurrent genera un errore.

Se si modifica il record corrente o si aggiunge un nuovo record quando si chiama CancelBatch, ADO chiama innanzitutto il metodo CancelUpdate per annullare le modifiche memorizzate nella cache. Successivamente, tutte le modifiche in sospeso nel recordset 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, è prudenziale 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 ha esito negativo 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. Un errore di run-time si verifica solo in caso di conflitti in tutti i record richiesti. Usare la proprietà Filter (adFilterAffectedRecords) e la proprietà Status per individuare i record con conflitti.

Si applica a

Oggetto Recordset (ADO)

Vedere anche

Esempio di metodi UpdateBatch e CancelBatch (VB)
Esempio di metodi UpdateBatch e CancelBatch (VC++)
Metodo Cancel (ADO)
Metodo Cancel (Servizi Desktop remoto)
Metodo CancelUpdate (ADO)
Metodo CancelUpdate (Servizi Desktop remoto)
Metodo Clear (ADO)
Proprietà LockType (ADO)
Metodo UpdateBatch