Transações distribuídas
Aplicável a: 
.NET Framework .NET .NET Standard
Uma transação é um conjunto de tarefas relacionadas que é bem-sucedida (confirmação) ou falha (anulação) como uma unidade, entre outras coisas. Uma transação distribuída é uma transação que afeta vários recursos. Para que uma transação distribuída seja confirmada, todos os participantes devem garantir que qualquer alteração nos dados será permanente. As alterações devem persistir mesmo que haja falhas do sistema ou outros eventos imprevisíveis. Mesmo se um único participante não fizer essa garantia, a transação inteira falhará e todas as alterações aos dados dentro do escopo da transação serão revertidas.
Observação
Para obter informações sobre transações distribuídas no Banco de Dados SQL do Azure e na Instância Gerenciada de SQL do Azure, confira Transações distribuídas entre bancos de dados de nuvem.
Trabalhando com System.Transactions
No .NET, as transações distribuídas são gerenciadas por meio da API no namespace System.Transactions. A API System.Transactions delegará a manipulação da transação distribuída para um monitor de transação como o Coordenador de transações distribuídas da Microsoft (DTC) quando vários gerentes de recurso persistentes estão envolvidos. Para obter mais informações, confira os Conceitos básicos da transação.
O ADO.NET 2.0 introduziu o suporte para inscrição em uma transação distribuída usando o método EnlistTransaction, que inscreve uma conexão em uma instância Transaction. Em versões anteriores do ADO.NET, a inscrição explícita em transações distribuídas foi realizada usando o método EnlistDistributedTransaction de uma conexão para inscrever uma conexão em uma instância ITransaction, que não tem suporte para compatibilidade com versões anteriores. Para obter mais informações sobre as transações de serviços corporativos, confira Interoperabilidade com os serviços corporativos e as transações COM+.
Ao usar uma transação System.Transactions com o Provedor de Dados Microsoft SqlClient para SQL Server em um banco de dados do SQL Server, um Transaction leve será usado automaticamente. A transação pode então ser promovida a uma transação distribuída completa conforme o necessário. Para obter mais informações, confira Integração de System.Transactions ao SQL Server.
Como se inscrever automaticamente em uma transação distribuída
A inscrição automática é a maneira padrão (e preferida) de integrar conexões ADO.NET com System.Transactions. Um objeto de conexão será inscrito automaticamente em uma transação distribuída existente se ele determinar que uma transação está ativa, o que, nos termos do System.Transaction, significa que Transaction.Current não é nulo. A inscrição automática de transação ocorre quando a conexão é aberta. Isso não ocorrerá depois disso, mesmo que um comando seja executado dentro de um escopo de transação. Você pode desabilitar a inscrição automática em transações existentes especificando Enlist=false como um parâmetro de cadeia de conexão para um SqlConnection.ConnectionString.
Como se inscrever manualmente em uma transação distribuída
Se a inscrição automática estiver desabilitada ou você precisar inscrever uma transação iniciada após a abertura da conexão, você poderá inscrevê-la em uma transação distribuída existente usando o método EnlistTransaction do objeto SqlConnection para o Provedor de Dados Microsoft SqlClient para SQL Server. A inscrição em uma transação atribuída existente garante que, se a transação for confirmada ou revertida, as alterações feitas pelo código na fonte de dados também serão confirmadas ou revertidas.
Observação
Uma exceção será gerada se você tentar confirmar ou reverter uma transação se um DataReader for iniciado enquanto a transação estiver ativa.
Inscrever-se em transações distribuídas é aplicável principalmente ao agrupar objetos de negócios. Se um objeto de negócios é agrupado com uma conexão aberta, a inscrição automática da transação ocorre somente quando essa conexão está aberta. Se várias transações são executadas usando o objeto comercial agrupado, a conexão aberta para esse objeto não se inscreverá automaticamente em transações iniciadas recentemente. Nesse caso, você pode desabilitar a inscrição automática de transação para a conexão e inscrever a conexão nas transações usando EnlistTransaction.
EnlistTransaction usa um só argumento do tipo Transaction que é uma referência para a transação existente. Após chamar o método EnlistTransaction da conexão, as modificações feitas na fonte de dados usando a conexão serão incluídas na transação. Passar um valor nulo cancela a inscrição da conexão de sua inscrição de transação distribuída atual. Observe que a conexão deve ser aberta antes de chamar EnlistTransaction.
Observação
Assim que uma conexão é inscrita explicitamente em uma transação, ela não pode ter a inscrição cancelada nem ser inscrita em outra transação até a primeira transação terminar.
Cuidado
EnlistTransaction gera uma exceção se a conexão já tiver começado uma transação usando o método BeginTransaction da conexão. No entanto, se a transação for uma transação local iniciada na fonte de dados (por exemplo, executando a instrução BEGIN TRANSACTION explicitamente usando uma SqlCommand), o EnlistTransaction reverterá a transação local e se inscreverá na transação distribuída existente conforme o solicitado. Você não receberá o aviso de que a transação local foi revertida e deverá gerenciar as transações locais não iniciadas usando BeginTransaction. Se você estiver usando o Provedor de Dados Microsoft SqlClient para SQL Server com o SQL Server, uma tentativa de inscrição vai gerar uma exceção. Todos os outros casos permanecerão despercebidos.
Transações passíveis de promoção no SQL Server
O SQL Server oferece suporte a transações passíveis de promoção nas quais uma transação leve local pode ser automaticamente promovida para uma transação distribuída somente se isso for necessário. Uma transação passível de promoção não chama a sobrecarga adicional de uma transação distribuída a menos que a sobrecarga adicional seja necessária. Para obter mais informações e um exemplo de código, confira Integração de System.Transactions ao SQL Server.
Configurando transações distribuídas
Você talvez precise habilitar o MS DTC na rede para usar transações distribuídas. Se o Firewall do Windows local do servidor estiver habilitado, você deverá permitir que o serviço do MS DTC use a rede ou abra a porta do MS DTC.