Utilizzo di System.Transactions

Si applica a:SQL Server

Lo spazio dei nomi System.Transactions fornisce un framework di transazione completamente integrato con ADO.NET e SQL Server'integrazione CLR (Common Language Runtime). La classe System.Transactions.TransactionScope rende transazionale un blocco di codice inserendo in modo implicito le connessioni in una transazione distribuita. È necessario chiamare il metodo Complete alla fine del blocco di codice contrassegnato da TransactionScope. Il metodo Dispose viene richiamato quando l'esecuzione del programma lascia un blocco di codice, causando l'interruzione della transazione se il metodo Complete non viene chiamato. Se è stata generata un'eccezione che determina l'uscita del codice dall'ambito, la transazione non viene più utilizzata.

È consigliabile utilizzare un blocco using per assicurarsi che il metodo Dispose venga chiamato sull'oggetto TransactionScope quando il blocco using viene chiuso. L'errore di eseguire il commit o il rollback delle transazioni in sospeso può compromettere gravemente le prestazioni perché il timeout predefinito per TransactionScope è di un minuto. Se non si usa un'istruzione using , è necessario eseguire tutte le operazioni in un blocco Try e chiamare in modo esplicito il metodo Dispose nel blocco Finally .

Se si verifica un'eccezione all'interno di TransactionScope, la transazione viene contrassegnata come incoerente e viene abbandonata. Viene eseguito il rollback quando TransactionScope viene eliminato. Se non si verifica alcuna eccezione, viene eseguito il commit delle transazioni partecipanti.

TransactionScope deve essere usato solo quando si accede a origini dati locali e remote o gestori risorse esterne. Ciò è dovuto al fatto che TransactionScope causa sempre la promozione delle transazioni, anche se viene usata solo all'interno di una connessione di contesto.

Nota

La classe TransactionScope crea una transazione con system.Transactions.Transaction.IsolationLevel di Serializable per impostazione predefinita. A seconda dell'applicazione, è possibile abbassare il livello di isolamento per evitare che si verifichi un numero elevato di contese.

Nota

È consigliabile eseguire solo aggiornamenti, inserimenti ed eliminazioni all'interno di transazioni distribuite sui server remoti in quanto tali operazioni comportano un notevole consumo di risorse del database. Se l'operazione viene effettuata sul server locale, non è necessario eseguire una transazione distribuita ed è sufficiente una transazione locale. Le istruzioni SELECT potrebbero bloccare inutilmente risorse del database e in alcuni scenari può essere necessario utilizzare le transazioni per le operazioni di selezione. Tutto il lavoro che non riguarda il database deve essere svolto all'esterno dell'ambito della transazione, a meno che non coinvolga altri gestori di risorse inclusi nella transazione. Sebbene un'eccezione all'interno dell'ambito della transazione impedisca il commit della transazione, la classe TransactionScope non dispone del provisioning per il rollback delle modifiche apportate dal codice all'esterno dell'ambito della transazione stessa. Se è necessario eseguire un'azione quando viene eseguito il rollback della transazione, è necessario scrivere la propria implementazione dell'interfaccia System.Transactions.IEnlistmentNotification ed eseguire esplicitamente l'integrazione nella transazione.

Esempio

Per utilizzare System.Transactions, è necessario avere un riferimento al file System.Transactions.dll.

Il codice seguente illustra come creare una transazione che può essere promossa in due istanze diverse di SQL Server. Queste istanze sono rappresentate da due diversi oggetti System.Data.SqlClient.SqlConnection , di cui viene eseguito il wrapping in un blocco TransactionScope . Il codice crea il blocco TransactionScope con un'istruzione using e apre la prima connessione, che lo inserisce automaticamente in TransactionScope. La transazione viene integrata inizialmente come transazione lightweight, non come transazione completamente distribuita. Il codice presuppone l'esistenza della logica condizionale, omessa per brevità. Apre la seconda connessione solo se necessario, integrandola in TransactionScope. Quando la connessione è aperta, la transazione viene promossa automaticamente a una transazione completamente distribuita. Il codice richiama quindi TransactionScope.Complete, che esegue il commit della transazione. Il codice elimina le due connessioni quando esce dalle istruzioni using per le connessioni. Il metodo TransactionScope.Dispose per TransactionScope viene chiamato automaticamente alla chiusura del blocco using per TransactionScope. Se è stata generata un'eccezione in qualsiasi punto del blocco TransactionScope , Complete non viene chiamato e la transazione distribuita eseguirà il rollback quando transactionScope viene eliminato.

Visual Basic

Using transScope As New TransactionScope()  
    Using connection1 As New SqlConnection(connectString1)  
        ' Opening connection1 automatically enlists it in the   
        ' TransactionScope as a lightweight transaction.  
        connection1.Open()  
  
        ' Do work in the first connection.  
  
        ' Assumes conditional logic in place where the second  
        ' connection will only be opened as needed.  
        Using connection2 As New SqlConnection(connectString2)  
            ' Open the second connection, which enlists the   
            ' second connection and promotes the transaction to  
            ' a full distributed transaction.  
            connection2.Open()  
  
            ' Do work in the second connection.  
  
        End Using  
    End Using  
  
    ' Commit the transaction.  
    transScope.Complete()  
End Using  

C#

using (TransactionScope transScope = new TransactionScope())  
{  
    using (SqlConnection connection1 = new   
       SqlConnection(connectString1))  
    {  
        // Opening connection1 automatically enlists it in the   
        // TransactionScope as a lightweight transaction.  
        connection1.Open();  
  
        // Do work in the first connection.  
  
        // Assumes conditional logic in place where the second  
        // connection will only be opened as needed.  
        using (SqlConnection connection2 = new   
            SqlConnection(connectString2))  
        {  
            // Open the second connection, which enlists the   
            // second connection and promotes the transaction to  
            // a full distributed transaction.   
            connection2.Open();  
  
            // Do work in the second connection.  
        }  
    }  
    //  The Complete method commits the transaction.  
    transScope.Complete();  
}  

Vedere anche

Integrazione con CLR e transazioni