WS 交易流程

發行項
02/28/2011

這個範例會示範用戶端協調交易的用法，以及使用 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 屬性時不可包含流動的交易。

若要啟用交易流程，除了適當的作業屬性 (Attribute) 外，也必須使用已啟用 <transactionFlow> 屬性 (Property) 的繫結。在此範例中，除了中繼資料交換端點以外，服務組態也會公開 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 介面的類別，將會以設定為 true 的 TransactionScopeRequired 屬性 (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 介面的定義包含設定為 TransactionFlowOption NotAllowed 的 TransactionFlowAttribute。
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。

若要在單一或跨機器的組態中執行本範例，請遵循Running the Windows Communication Foundation Samples中的指示進行。

注意：
若為跨電腦組態，請使用下列指示來啟用分散式交易協調器，然後使用 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. 按一下 [確定] 關閉對話方塊。

注意：
這些範例可能已安裝在您的電腦上。請先檢查下列 (預設) 目錄，然後再繼續。 `<InstallDrive>:\WF_WCF_Samples` 如果此目錄不存在，請移至用於 .NET Framework 4 的 Windows Communication Foundation (WCF) 與 Windows Workflow Foundation (WF) 範例 (英文)，以下載所有 Windows Communication Foundation (WCF) 和 WF 範例。此範例位於下列目錄。 `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\TransactionFlow`

注意：

這些範例可能已安裝在您的電腦上。請先檢查下列 (預設) 目錄，然後再繼續。

<InstallDrive>:\WF_WCF_Samples

如果此目錄不存在，請移至用於 .NET Framework 4 的 Windows Communication Foundation (WCF) 與 Windows Workflow Foundation (WF) 範例 (英文)，以下載所有 Windows Communication Foundation (WCF) 和 WF 範例。此範例位於下列目錄。

<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\TransactionFlow

共用方式為

WS 交易流程

若要設定、建置及執行範例

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

其他資源