Método Close (ADO)

Fecha um objeto aberto e todos os objetos dependentes.

Sintaxe

  
object.Close  

Comentários

Use o método Close para fechar uma Connection, um Record, um Recordset ou um objeto Stream para liberar todos os recursos do sistema associados. O fechamento de um objeto não o remove da memória. Você pode alterar as configurações de propriedade dele e abri-lo novamente mais tarde. Para eliminar completamente um objeto da memória, feche o objeto e defina a variável de objeto como Nothing (em Visual Basic).

Conexão

O uso do método Close para fechar um objeto Connection também fecha todos os objetos Recordset ativos associados à conexão. Um objeto Command associado ao objeto Connection que você está fechando será persistente, mas ele não será mais associado a um objeto Connection, ou seja, a propriedade ActiveConnection será definida como Nothing. Além disso, a coleção Parameters do objeto Command será desmarcada de todos os parâmetros definidos pelo provedor.

Posteriormente, você poderá chamar o método Open para restabelecer a conexão com a mesma fonte de dados ou outra. Embora o objeto Connection esteja fechado, a chamada a todos os métodos que exigem uma conexão aberta com a fonte de dados gera um erro.

O fechamento de um objeto Connection enquanto há objetos Recordset abertos na conexão reverte todas as alterações pendentes em todos os objetos Recordset. O fechamento explícito de um objeto Connection (pela chamada do método Close) enquanto uma transação está em andamento gera um erro. Se um objeto Connection ficar fora do escopo enquanto uma transação estiver em andamento, o ADO reverterá automaticamente a transação.

Recordset, Record, Stream

O uso do método Close para fechar um objeto Recordset, Record ou Stream libera os dados associados e qualquer acesso exclusivo que você possa ter tido aos dados por meio desse objeto específico. Posteriormente, você poderá chamar o método Open para reabrir o objeto com os atributos idênticos ou modificados.

Enquanto um objeto Recordset está fechado, a chamada a todos os métodos que exigem um cursor dinâmico gera um erro.

Se uma edição estiver em andamento no modo de atualização imediata, a chamada do método Close vai gerar um erro. Em vez disso, chame primeiro o método Update ou CancelUpdate. Se você fechar o objeto Recordset enquanto estiver no modo de atualização em lote, todas as alterações desde a última chamada UpdateBatch serão perdidas.

Se você usar o método Clone para criar cópias de um objeto Recordset aberto, o fechamento do original ou de um clone não afetará nenhuma das outras cópias.

Aplica-se A

Objeto Connection (ADO)
Objeto Record (ADO)

Objeto Recordset (ADO)
Objeto Stream (ADO)

Consulte Também

Exemplo dos métodos Open e Close (VB)
Exemplo dos métodos Open e Close (VBScript)
Exemplo dos métodos Open e Close (VC++)
Método Open (conexão ADO)
Método Open (Conjunto de registros ADO)
Método Save