WS 交易流程

發行項
05/10/2023

這個交易流程範例會示範用戶端協調交易的用法，以及使用 WS-Atomic 交易或 OleTransactions 通訊協定之交易流程的用戶端和伺服器選項。這個範例是以使用者入門為基礎，此範例會實作計算機服務，但會屬性化作業以示範如何搭配使用 TransactionFlowAttribute 和 TransactionFlowOption 列舉，進而判斷啟用的交易流程程度。在流動的異動範圍內，會將所要求作業的記錄檔寫入資料庫，並在完成用戶端協調異動之前都會保存該記錄檔。如果用戶端異動未完成，Web 服務異動一定不會認可對資料庫進行適當的更新。

注意

此範例的安裝程序與建置指示位於本主題的結尾。

初始服務和異動的連線之後，用戶端會存取一些服務作業。將使用示範 TransactionFlowOption 之不同設定的每項作業，以下列方式定義服務的合約。

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
public interface ICalculator
{
    [OperationContract]
    [TransactionFlow(TransactionFlowOption.Mandatory)]
    double Add(double n1, double n2);
    [OperationContract]
    [TransactionFlow(TransactionFlowOption.Allowed)]
    double Subtract(double n1, double n2);
    [OperationContract]
    [TransactionFlow(TransactionFlowOption.NotAllowed)]
    double Multiply(double n1, double n2);
    [OperationContract]
    double Divide(double n1, double n2);
}

將以處理作業的順序定義這些作業：

Add 作業要求必須包括流動的交易。
Subtract 作業要求可能包括流動的交易。
Multiply 作業要求不可在明確的 NotAllowed 設定中包含流動的異動。
Divide 作業要求在省略 TransactionFlow 屬性時不可包含流動的異動。

若要啟用交易流程，除了適當的作業屬性外，也必須使用已啟用 <transactionFlow> 屬性的繫結。在此範例中，除了中繼資料交換端點以外，服務組態也會公開 TCP 端點和 HTTP 端點。 TCP 端點和 HTTP 端點會使用下列繫結，而這些繫結都已啟用 <transactionFlow> 屬性。

<bindings>
  <netTcpBinding>
    <binding name="transactionalOleTransactionsTcpBinding"
             transactionFlow="true"
             transactionProtocol="OleTransactions"/>
  </netTcpBinding>
  <wsHttpBinding>
    <binding name="transactionalWsatHttpBinding"
             transactionFlow="true" />
  </wsHttpBinding>
</bindings>

注意

系統提供的 netTcpBinding 允許使用 transactionProtocol 規格，而系統提供的 wsHttpBinding 僅使用更具互通性的 WSAtomicTransactionOctober2004 通訊協定。 OleTransactions 通訊協定僅能於 Windows Communication Foundation (WCF) 用戶端使用。

針對實作 ICalculator 介面的類別，將會以設定為 TransactionScopeRequired 的 true 屬性 (Property)，屬性化 (Attributed) 所有方法。這個設定的宣告為，將會在交易範圍內發生方法內採用的所有動作。在此情況下，採取的動作包含記錄資料庫的記錄。如果作業要求中包含流動的異動，則會在傳入異動範圍內發生動作，或者自動產生新的異動範圍。

注意

TransactionScopeRequired 屬性會定義服務方法實作的本機行為，而不會定義用戶端的能力或流動交易的需求。

// Service class that implements the service contract.
[ServiceBehavior(TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable)]
public class CalculatorService : ICalculator
{
    [OperationBehavior(TransactionScopeRequired = true)]
    public double Add(double n1, double n2)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Adding {0} to {1}", n1, n2));
        return n1 + n2;
    }

    [OperationBehavior(TransactionScopeRequired = true)]
    public double Subtract(double n1, double n2)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Subtracting {0} from {1}", n2, n1));
        return n1 - n2;
    }

    [OperationBehavior(TransactionScopeRequired = true)]
    public double Multiply(double n1, double n2)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Multiplying {0} by {1}", n1, n2));
        return n1 * n2;
    }

    [OperationBehavior(TransactionScopeRequired = true)]
    public double Divide(double n1, double n2)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Dividing {0} by {1}", n1, n2));
        return n1 / n2;
    }

    // Logging method omitted for brevity
}

在用戶端上，作業之服務的 TransactionFlowOption 設定會反映在 ICalculator 介面之用戶端產生的定義中。同時，服務的 transactionFlow 屬性設定則反映在用戶端的應用程式組態中。透過選擇適當的 endpointConfigurationName，用戶端便可選取傳輸和通訊協定。

// Create a client using either wsat or oletx endpoint configurations
CalculatorClient client = new CalculatorClient("WSAtomicTransaction_endpoint");
// CalculatorClient client = new CalculatorClient("OleTransactions_endpoint");

注意

不管選擇哪個通訊協定或傳輸，此範例所觀察的行為都一樣。

初始服務連線時，用戶端會在呼叫服務作業時建立新的 TransactionScope。

// Start a transaction scope
using (TransactionScope tx =
            new TransactionScope(TransactionScopeOption.RequiresNew))
{
    Console.WriteLine("Starting transaction");

    // Call the Add service operation
    //  - generatedClient will flow the required active transaction
    double value1 = 100.00D;
    double value2 = 15.99D;
    double result = client.Add(value1, value2);
    Console.WriteLine("  Add({0},{1}) = {2}", value1, value2, result);

    // Call the Subtract service operation
    //  - generatedClient will flow the allowed active transaction
    value1 = 145.00D;
    value2 = 76.54D;
    result = client.Subtract(value1, value2);
    Console.WriteLine("  Subtract({0},{1}) = {2}", value1, value2, result);

    // Start a transaction scope that suppresses the current transaction
    using (TransactionScope txSuppress =
                new TransactionScope(TransactionScopeOption.Suppress))
    {
        // Call the Subtract service operation
        //  - the active transaction is suppressed from the generatedClient
        //    and no transaction will flow
        value1 = 21.05D;
        value2 = 42.16D;
        result = client.Subtract(value1, value2);
        Console.WriteLine("  Subtract({0},{1}) = {2}", value1, value2, result);

        // Complete the suppressed scope
        txSuppress.Complete();
    }

    // Call the Multiply service operation
    // - generatedClient will not flow the active transaction
    value1 = 9.00D;
    value2 = 81.25D;
    result = client.Multiply(value1, value2);
    Console.WriteLine("  Multiply({0},{1}) = {2}", value1, value2, result);

    // Call the Divide service operation.
    // - generatedClient will not flow the active transaction
    value1 = 22.00D;
    value2 = 7.00D;
    result = client.Divide(value1, value2);
    Console.WriteLine("  Divide({0},{1}) = {2}", value1, value2, result);

    // Complete the transaction scope
    Console.WriteLine("  Completing transaction");
    tx.Complete();
}

Console.WriteLine("Transaction committed");

作業的呼叫如下所示：

Add 要求會將必要的異動流動至服務，而服務的動作則是在用戶端的異動範圍內發生。
第一個 Subtract 要求也會將允許的交易流動至服務，而服務的動作再次是在用戶端的交易範圍內發生。
第二個 Subtract 要求會在以 TransactionScopeOption.Suppress 選項宣告的新交易範圍內執行。這樣做會隱藏用戶端的初始外部異動，而且要求不會將異動流動至服務。這個方法可讓用戶端明確地不參與，並在不需要將交易流動至服務時，防止進行此動作。會在新的和未連接的異動範圍內發生服務動作。
Multiply 要求不會將異動流動至服務，因為用戶端產生之 ICalculator 介面的定義包含設定為 TransactionFlowAttribute TransactionFlowOption 的 NotAllowed。
Divide 要求不會將交易流動至服務，因為用戶端產生之 ICalculator 介面的定義再次不包含 TransactionFlowAttribute。再次會在其他新的和未連接的異動範圍內發生服務動作。

當您執行範例時，作業要求和回應會顯示在用戶端主控台視窗中。在用戶端視窗中按下 ENTER 鍵，即可關閉用戶端。

Starting transaction
  Add(100,15.99) = 115.99
  Subtract(145,76.54) = 68.46
  Subtract(21.05,42.16) = -21.11
  Multiply(9,81.25) = 731.25
  Divide(22,7) = 3.14285714285714
  Completing transaction
Transaction committed
Press <ENTER> to terminate client.

服務作業要求的記錄會顯示在服務的主控台視窗中。在用戶端視窗中按下 ENTER 鍵，即可關閉用戶端。

Press <ENTER> to terminate the service.
  Writing row to database: Adding 100 to 15.99
  Writing row to database: Subtracting 76.54 from 145
  Writing row to database: Subtracting 42.16 from 21.05
  Writing row to database: Multiplying 9 by 81.25
  Writing row to database: Dividing 22 by 7

成功執行之後，會完成用戶端交易範圍，並且認可該範圍內採取的所有動作。特別來說，記下的 5 筆記錄會保存在服務的資料庫中。前兩項則是在用戶端的交易範圍內發生。

如果在用戶端的 TransactionScope 任意處發生例外狀況，則無法完成異動。這會導致在該範圍內記載的記錄，不會對資料庫認可。在取消註解呼叫以完成外部 TransactionScope 之後，重複執行範例即可觀察這個影響。在這種執行中，只會記錄後三個動作 (第二個 Subtract、Multiply 和 Divide 要求)，這是因為用戶端交易並沒有流動至這三項。

若要安裝、建置及執行範例

若要建置解決方案的 C# 或 Visual Basic .NET 版本，請遵循建置 Windows Communication Foundation 範例中的指示
確定您已安裝 SQL Server Express Edition 或 SQL Server，而且已在服務的應用程式組態檔中正確設定連接字串。若要在不使用資料庫的情況下執行範例，請將服務之應用程式組態檔中的 usingSql 值設定為 false
若要在單一或多台機器設定中執行此範例，請遵循執行 Windows Communication Foundation 範例的指示。

注意

若為跨電腦組態，請使用下列指示來啟用分散式異動協調器，然後使用 Windows SDK 中的 WsatConfig.exe 工具來啟用 WCF 異動網路支援。如需設定 WsatConfig.exe 的詳細資訊，請參閱設定 WS-Atomic 交易支援。

不管是在同一部電腦還是不同電腦上執行範例，都必須設定 Microsoft Distributed Transaction Coordinator (MSDTC) 以啟用網路交易流程，並使用 WsatConfig.exe 工具來啟用 WCF 交易網路支援。

若要設定 Microsoft Distributed Transaction Coordinator (MSDTC) 以支援執行範例

在執行 Windows Server 2003 或 Windows XP 的服務電腦上，請遵循下列指示設定 MSDTC 以允許傳入網路異動。
1. 從 [開始] 功能表中，依序瀏覽至 [控制台]、[系統管理工具] 和 [元件服務]。
2. 展開 [元件服務]。開啟 [電腦] 資料夾。
3. 以滑鼠右鍵按一下 [我的電腦]，然後選取 [屬性]。
4. 按一下 [MSDTC] 索引標籤上的 [安全性組態]。
5. 核取 [網路 DTC 存取] 和 [允許輸入]。
6. 按一下 [確定]，然後按一下 [是]，重新啟動 MSDTC 服務。
7. 按一下 [確定] ，關閉對話方塊。
在執行 Windows Server 2008 或 Windows Vista 的服務電腦上，請遵循下列指示設定 MSDTC 以允許傳入網路異動。
1. 從 [開始] 功能表中，依序瀏覽至 [控制台]、[系統管理工具] 和 [元件服務]。
2. 展開 [元件服務]。開啟 [電腦] 資料夾。選取 [分散式交易協調器]。
3. 以滑鼠右鍵按一下 [DTC 協調器] 並選取 [屬性]。
4. 在 [安全性] 索引標籤上，核取 [網路 DTC 存取] 和 [允許輸入]。
5. 按一下 [確定]，然後按一下 [是]，重新啟動 MSDTC 服務。
6. 按一下 [確定] ，關閉對話方塊。
在用戶端電腦上，設定 MSDTC 以允許傳出網路交易：
1. 從 [開始] 功能表中，依序瀏覽至 Control Panel、[系統管理工具] 和 [元件服務]。
2. 以滑鼠右鍵按一下 [我的電腦]，然後選取 [屬性]。
3. 按一下 [MSDTC] 索引標籤上的 [安全性組態]。
4. 核取 [網路 DTC 存取] 和 [允許輸出]。
5. 按一下 [確定]，然後按一下 [是]，重新啟動 MSDTC 服務。
6. 按一下 [確定] ，關閉對話方塊。

共用方式為

WS 交易流程

若要安裝、建置及執行範例

若要設定 Microsoft Distributed Transaction Coordinator (MSDTC) 以支援執行範例

其他資源