Metodo CancelBatch (ADO)

  • Articolo

Annulla un aggiornamento batch in sospeso.

Sintassi

  
recordset.CancelBatchAffectRecords

Parametri

AffectRecords
facoltativo. Valore AffectEnum che indica il numero di record che saranno interessati dal metodo CancelBatch.

Osservazioni

Usare il metodo CancelBatch per annullare gli aggiornamenti in sospeso in un oggetto Recordset in modalità di aggiornamento batch. Se l'oggetto Recordset è in modalità di aggiornamento immediato e si chiama CancelBatch senza adAffectCurrent, viene generato 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 eventuali modifiche memorizzate nella cache. In seguito, tutte le modifiche in sospeso presenti nell'oggetto Recordset vengono annullate.

Il record corrente può essere indeterminabile dopo una chiamata a CancelBatch, soprattutto se è in corso l'aggiunta di un nuovo record. Per questo motivo, è consigliabile impostare la posizione corrente del record su una posizione nota nell'oggetto Recordset dopo la chiamata a CancelBatch. Ad esempio, chiamare il metodo MoveFirst.

Se il tentativo di annullamento degli 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. Usare la proprietà Filter (adFilterConflictingRecords) e la proprietà Status per individuare i record con conflitti.

Si applica a

Oggetto Recordset (ADO)

Vedere anche

Esempio dei metodi UpdateBatch e CancelBatch (VB)
Esempio dei 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