Método Close (ADO)

Fecha um objeto aberto e quaisquer objetos dependentes.

Sintaxe

  
object.Close  

Observações

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

Conexão

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

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

Fechar um objeto Connection enquanto há objetos Recordset abertos na conexão reverte as alterações pendentes em todos os objetos recordset. Fechar explicitamente um objeto Connection (chamando o 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.

Conjunto de registros, registro, fluxo

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

Enquanto um objeto Recordset é fechado, chamar 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, chamar o método Fechar 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 o último updateBatch chamada serão perdidas.

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

Aplica-se a

do objeto de conexão (ADO)
do objeto de registro (ADO)

do objeto Recordset (ADO)
objeto stream (ADO)

Consulte Também

exemplo de métodos abertos e fechados (VB)
exemplo de métodos abertos e fechados (VBScript)
exemplo de métodos abertos e fechados (VC++)
método open (conexão ADO)
do método Open (ADO Recordset)
salvar método