Metodo Close (ADO)

Chiude un oggetto aperto e tutti gli oggetti dipendenti.

Sintassi

  
object.Close  

Osservazioni

Usare il metodo Close per chiudere un oggetto Connection, Record, Recordset o Stream per liberare tutte le risorse di sistema associate. La chiusura di un oggetto non lo rimuove dalla memoria; è possibile modificarne le impostazioni delle proprietà e aprirlo di nuovo in un secondo momento. Per eliminare completamente un oggetto dalla memoria, chiudere l'oggetto e quindi impostare la variabile oggetto su Nothing (in Visual Basic).

Connessione

L'uso del metodo Close per chiudere un oggetto Connection chiude anche tutti gli oggetti Recordset attivi associati alla connessione. Un oggetto Command associato all'oggetto Connection che viene chiuso persiste, ma non sarà più associato a un oggetto Connection; in altre parole, la proprietà ActiveConnection verrà impostata su Nothing. Inoltre, dalla raccolta Parameters dell'oggetto Command verranno cancellati tutti i parametri definiti dal provider.

È possibile chiamare in un secondo momento il metodo Open per stabilire nuovamente la connessione alla stessa o a un'altra origine dati. Mentre l'oggetto Connection viene chiuso, la chiamata di tutti i metodi che richiedono una connessione aperta all'origine dati genera un errore.

La chiusura di un oggetto Connection mentre sono presenti oggetti Recordset aperti nella connessione esegue il rollback di eventuali modifiche in sospeso in tutti gli oggetti Recordset. La chiusura in modo esplicito di un oggetto Connection (chiamata al metodo Close) mentre una transazione è in corso genera un errore. Se un oggetto Connection non rientra nell'ambito mentre una transazione è in corso, ADO esegue automaticamente il rollback della transazione.

Recordset, Record, Stream

L’utilizzo del metodo Close per chiudere un oggetto Recordset, Record o Stream rilascia i dati associati e qualsiasi accesso esclusivo ai dati di cui si disponeva tramite questo particolare oggetto. È possibile chiamare in seguito il metodo Open per riaprire l'oggetto con gli stessi attributi o attributi modificati.

Durante la chiusura di un oggetto Recordset, la chiamata di tutti i metodi che richiedono un cursore live genera un errore.

Se è in corso una modifica nella modalità di aggiornamento immediato, la chiamata al metodo Close genera un errore. In alternativa, chiamare prima il metodo Update o CancelUpdate. Se si chiude l'oggetto Recordset durante la modalità di aggiornamento batch, tutte le modifiche apportate dall'ultima chiamata di UpdateBatch vengono perse.

Se si usa il metodo Clone per creare copie di un oggetto Recordset aperto, la chiusura dell'originale o di un clone non influisce su nessuna delle altre copie.

Si applica a

Oggetto Connection (ADO)
Oggetto Record (ADO)

Oggetto Recordset (ADO)
Oggetto Stream (ADO)

Vedere anche

Esempio dei metodi Open e Close (VB)
Esempio dei metodi Open e Close (VBScript)
Esempio dei metodi Open e Close (VC++)
Metodo Open (Connection - ADO)
Metodo Open (Recordset - ADO)
Metodo Save