Processamento de transações

Aplica-se ao: Access 2013, Office 2013

O ADO fornece os seguintes métodos para controlar transações: BeginTrans, CommitTrans e RollbackTrans. Use esses métodos com um objeto Connection quando desejar salvar ou cancelar uma série de alterações feitas na fonte de dados como uma única unidade. Por exemplo, para transferir dinheiro entre contas, subtraia um valor de uma conta e acrescente o mesmo valor à outra. Se uma das duas atualizações falhar, as contas ficarão desequilibradas. A realização dessas alterações em uma transação aberta garante que todas as alterações, ou nenhuma delas, ocorram.

Observação

Nem todos os provedores oferecem suporte a transações. Verifique se a propriedade "Transaction DDL" definida pelo provedor aparece na coleção Properties do objeto Connection, indicando o suporte do provedor a transações. Se o provedor não oferecer esse suporte, um erro ocorrerá quando você chamar um desses métodos.

Depois que você chamar o método BeginTrans, o provedor não confirmará mais instantaneamente as alterações feitas até que CommitTrans ou RollbackTrans seja chamado para finalizar a transação.

A chamada do método CommitTrans salva as alterações feitas em uma transação aberta na conexão e finaliza a transação. A chamada do método RollbackTrans reverte qualquer alteração feita em uma transação aberta e finaliza a transação. A chamada de um desses dois métodos quando não houver transação aberta gerará erro.

Dependendo da propriedade Attributes do objeto Connection, a chamada do método CommitTrans ou RollbackTrans poderá iniciar automaticamente uma nova transação. Se a propriedade Attributes for definida como adXactCommitRetaining, o provedor iniciará automaticamente uma nova transação após a chamada de CommitTrans. Se a propriedade Attributes for definida como adXactAbortRetaining, o provedor iniciará automaticamente uma nova transação após a chamada de RollbackTrans.

Nível de isolamento de transação

Use a propriedade IsolationLevel para definir o nível de isolamento de uma transação em um objeto Connection. A configuração não tem efeito até a próxima vez que você chamar o método BeginTrans. Se o nível de isolamento solicitado estiver indisponível, o provedor pode retornar o próximo nível de isolamento maior. Consulte a propriedade IsolationLevel na referência do programador do ADO para obter mais detalhes sobre valores válidos.

Transações aninhadas

Para os provedores que oferecem suporte a transações aninhadas, uma nova transação aninhada será iniciada quando você chamar o método BeginTrans em uma transação aberta. O valor de retorno indica o nível de aninhamento: o valor de retorno "1" indica que você abriu uma transação de nível superior (ou seja, a transação não está aninhada em outra transação), "2" indica que você abriu uma transação de segundo nível e assim por diante. A chamada de CommitTrans ou RollbackTrans afeta apenas a transação aberta mais recentemente; você deve fechar ou reverter a transação atual antes de resolver qualquer transação de nível superior.