TransactionScope事務處理方法介紹及.NETCore中的注意事項

依樂祝發表於2018-12-29
NetCore

作者：依樂祝

原文連結：https://www.cnblogs.com/yilezhu/p/10170712.html

今天在寫CzarCms的UnitOfWork的使用使用到了這個TransactionScope事務，因此對它進行了相關資料的查閱並記錄如下，希望對大夥在.NET Core中使用有所幫助。

寫在前面

您是否曾嘗試使用C＃程式碼來實現事務？通常，我們在SQL中一次執行多個Insert / Update語句的話可能就會使用到事務。事務遵循ACID（原子性，一致性，隔離性，永續性）規則，這樣所有的語句要麼全部執行成功要麼全部被取消並執行回滾操作。 而我們今天要講的TransactionScope則可以允許我們在應用程式級別實現這個過程。在某些情況下，您可能需要在同一個資料庫甚至多個資料庫（分散式事務）中執行不同的操作，或者由於某些其他約束，它無法在資料庫級別來完成，或者應用程式的開發人員對資料庫的接觸較少，那麼這時候TransactionScope將會讓你遊刃有餘。

什麼是TransactionScope呢？

TransactionScope作為System.Transactions的一部分被引入到.NET 2.0。同時SqlClient for .NET Core 從 2.1 及以上版本開始提供對System.Transactions的支援 。 它是一個類，它提供了一種簡單的方法，可以將一組操作作為事務的一部分來進行處理，而不必擔心場景背後的複雜性。如果某個操作在執行的過程中失敗的話，則整個事務將失敗並執行回滾操作，從而撤消已完成的所有操作。所有這些都將由框架處理，從而確保資料的一致性。

如何使用TransactionScope呢？

要使用它，您需要新增System.Transactions的引用，如果你使用的是.net core的話。這個引用被包含在netcoreapp2.2System.Transactions.Local.dll 中， 該引用是框架庫的一部分（通常預設情況下不會自動新增）。新增後，在我們想要使用它的地方新增名稱空間 System.Transactions即可。程式碼如下所示：

try
{
    using (TransactionScope scope = new TransactionScope())
    {
        // Do Operation 1
        // Do Operation 2
        //...
 
        // 如果所有的操作都執行成功，則Complete()會被呼叫來提交事務
        // 如果發生異常，則不會呼叫它並回滾事務
        scope.Complete();
    }
}
catch (ThreadAbortException ex)
{
    // 處理異常
}

在上面的程式碼中我們可以看到我們在建立TransactionScope例項時使用了using 語句塊及Disposable塊，它確保了當dispose離開塊並結束事務範圍時呼叫dispose來進行資源的釋放。
在一個Transaction範圍中，我們可以做多個連線甚至連結到不同資料庫的操作的，如下所示：

using (TransactionScope scope = new TransactionScope())
{
    using (con = new SqlConnection(conString1))
    {
        con.Open();
 
        // 執行操作 1
        // 執行操作 2
        //...
    }
 
    using (con = new SqlConnection(conString2))
    {
        con.Open();
 
        // 執行操作 1
        // 執行操作 2
        //...
 
    }
 
    scope.Complete();
}

下面我們使用兩個不同的資料庫連線字串來連線不同的資料庫。當然我們也可以根據我們的業務要求使用盡可能多資料庫。我們也可以再事務中巢狀事務。如下程式碼所示：

public void DoMultipleTransaction()
{       
    try
    {
        using (TransactionScope scope = new TransactionScope())
        {
            using (con = new SqlConnection(conString1))
            {
                con.Open();
                // 執行操作1
            }
 
            OtherTransaction();
            scope.Complete();
        }
    }
    catch (ThreadAbortException ex)
    {
        // 處理異常
    }
}
 
private void OtherTransaction()
{
    using (TransactionScope scope = new TransactionScope())
    {
        using (con = new SqlConnection(conString2))
        {
            con.Open();
            // 執行操作
        }
        scope.Complete();
    }
}

這裡最頂層的事務範圍稱為根範圍。另外這裡需要注意的是即使通過呼叫scope.Complete（）完成內部事務（上面的OtherTransaction ），如果由於各種原因無法呼叫rootscope complete，那麼整個事務也將被回滾包括內部的事務。

*注意：執行分散式trsanctions時，您可能會收到以下異常之一*

  1. 伺服器上的MSDTC不可用
  2. 已禁用分散式事務管理器（MSDTC）的網路訪問。

這兩個錯誤都是由於同樣的原因，第一個是在資料庫和應用程式是同一個伺服器時發生的，而在另一個則是服務跟資料庫分別部署在兩臺伺服器上。對於同一臺伺服器，請轉到run-> cmd-> services.msc。執行名為Distributed Transaction Coordinator的服務並自動啟動啟動型別，以便在系統重新啟動時再次啟動它。對於2，你可能需要參照這個連結的內容進行相應的設定

TransactionScope 類提供了多個過載建構函式，它們接受 TransactionScopeOption 型別的列舉，而該列舉定義事務範圍行為。

TransactionScope物件有以下三個選項：

  • Required：聯接環境事務，或者在環境事務不存在的情況下建立新的環境事務。
  • RequiresNew：成為新的根範圍，也就是說，啟動一個新事務並使該事務成為其自己範圍中的新環境事務。
  • Suppress：根本不參與事務。 因此沒有環境事務。

如果用 Required] 例項化範圍並且存在環境事務，則該範圍會聯接該事務。 相反，如果不存在環境事務，該範圍就會建立新的事務併成為根範圍。 這是預設值。 在使用 Required時，無論範圍是根範圍還是僅聯接環境事務，該範圍中的程式碼都不需要有不同的行為。 該程式碼在這兩種情況下的行為應相同。

如果用 RequiresNew 例項化範圍，則它始終為根範圍。 它會啟動一個新事務，並且其事務成為該範圍中的新環境事務。

如果用 Suppress 例項化範圍，則無論是否存在環境事務，範圍都從不參與事務。 始終使用此值例項化的作用域具有null作為其環境事務。

下面來讓我們看一組例項程式碼：

using (TransactionScope scope = new TransactionScope())
{
    // 聯接環境事務，或者在環境事務不存在的情況下建立新的環境事務。
    using (TransactionScope scope1 = new TransactionScope(TransactionScopeOption.Required))
    {
        // Do Operation
        scope1.Complete();
    }
    //成為新的根範圍，也就是說，啟動一個新事務並使該事務成為其自己範圍中的新環境事務。
    using (TransactionScope scope2 = new TransactionScope(TransactionScopeOption.RequiresNew))
    {
        // Do Operation
        scope2.Complete();
    }
    //根本不參與事務。 因此沒有環境事務。
    using (TransactionScope scope3 = new TransactionScope(TransactionScopeOption.Suppress))
    {
        // Do Operation
        scope3.Complete();
    }
 
    scope.Complet

在這裡，我們使用不同的TransactionScopeOptions在父事務下建立了三個事務。預設情況下，範圍是required ，這裡父事務就是採用的這個預設引數進行建立的。它是一個建立新事務的根範圍，並將其標記為環境事務。scope1也是使用required建立的，因為我們已經有了一個環境事務（範圍），所以它加入到父事務中。scope2是使用RequiresNew選項建立的，這意味著它是一個獨立於環境事務處理的新事務。scope3是用suppress建立的選項，這意味著它不參與任何環境事務。無論環境事務是否成功執行，它都會被執行。父（全域性）範圍完成後，將提交所有環境事務。

注意點

  1. EF Core 依賴資料庫提供程式以實現對 System.Transactions 的支援。 雖然支援在 .NET Framework 的 ADO.NET 提供程式之間十分常見，但最近才將 API 新增到 .NET Core，因此支援並未得到廣泛應用。 如果提供程式未實現對 System.Transactions 的支援，則可能會完全忽略對這些 API 的呼叫。 SqlClient for .NET Core 從 2.1 及以上版本開始支援 System.Transactions。如果嘗試在低版本中 如.NET Core 2.0中嘗試使用該功能將引發異常。
  1. 自版本 2.1 起，.NET Core 中的 System.Transactions 實現將不包括對分散式事務的支援，因此不能使用 TransactionScope 或 CommittableTransaction 來跨多個資源管理器協調事務。主要是不依賴windows中的mstsc功能。
  2. 非同步方法使用時需要注意：

在下面的例子中，我們在TransactionScope內部使用await。

using（var scope = new TransactionScope（））
{ 
  var groups = await Context.ProductGroups.ToListAsync（）。ConfigureAwait（false）; 
}

看起來沒有問題，但它會丟擲一個 System.InvalidOperationException:`A TransactionScope must be disposed on the same thread that it was created.`

原因是預設情況下TransactionScope不會從一個執行緒切換到另一個執行緒。為了解決這個問題，我們必須使用 TransactionScopeAsyncFlowOption.Enabled：

using（var scope = new TransactionScope（TransactionScopeAsyncFlowOption.Enabled））
{ 
  var groups = await Context.ProductGroups.ToListAsync（）。ConfigureAwait（false）; 
}

現在應該可以了吧？這取決於下面的情況。

如果我們使用和不使用TransactionScopeAsyncFlowOption這個選項的時候都使用了相同的資料庫連線，並且第一次執行的時候沒有使用這個選項，那麼我們會得到另一個異常： System.InvalidOperationException:`Connection currently has transaction enlisted. Finish current transaction and retry.`

換句話說，由於第一個訪問的原因，第二個會話將會失敗。如下程式碼所示：

try
{
  using (var scope = new TransactionScope())
  {
    // We know this one - System.InvalidOperationException: 
    // TransactionScope必須放在與建立它相同的執行緒上。
    var groups = await Context.ProductGroups.ToListAsync().ConfigureAwait(false);
 }
}
catch (Exception e)
{
  // error handling
}

using (var scope = new TransactionScope(TransactionScopeAsyncFlowOption.Enabled))
{
  // Implemented correctly but throws anyways
  // System.InvalidOperationException:
  // 當前連線已經被記錄。完成當前事務並重試。
  var groups = await Context.ProductGroups.ToListAsync().ConfigureAwait(false);
}

想象一下，如果第一個呼叫是在第三方庫或您正在使用的框架中完成的，二您不瞭解其中的程式碼 – 如果您之前沒有看到此錯誤，那麼你講無從下手來解決這個問題。

## 總結

本文帶著大家熟悉了一遍TransactionScope並對其使用進行了介紹！同時介紹了在.NET Core中使用TransactionScope的一些注意事項！希望對大家有所幫助。


相關文章