共用方式為

ServiceModel 交易屬性

  • 發行項

Windows Communication Foundation (WCF) 提供三個標準 System.ServiceModel 屬性 (Attribute) 的屬性 (Property)，能夠讓您設定 WCF 服務的交易行為：

TransactionFlowAttribute

TransactionFlowAttribute 屬性指定服務合約中的作業是否願意接受來自用戶端的傳入交易。屬性 (Attribute) 使用下列屬性 (Property) 提供這項控制：交易使用 TransactionFlowOption 列舉以指定傳入交易是否為 Mandatory、Allowed 或 NotAllowed。

這是唯一將服務作業與外部用戶端互動產生關聯的屬性。下列章節中描述的屬性與使用執行作業內的交易有關。

ServiceBehaviorAttribute

ServiceBehaviorAttribute 屬性指定服務合約實作的內部執行行為。這個屬性 (Attribute) 的交易特定屬性 (Property) 包括：

  • TransactionAutoCompleteOnSessionClose 指定當工作階段關閉時是否會完成未完成的交易。這個屬性的預設值為 false。如果這個屬性是 true，並且傳入工作階段依正常程序關閉，而不是因為網路或用戶端錯誤導致關閉，則任何未完成的交易都會成功完成。否則，如果這個屬性是 false，或是如果工作階段不是依正常程序關閉，則當工作階段關閉時就會復原未完成的交易。如果這個屬性是 true，則傳入通道必須是以工作階段為依據。
  • ReleaseServiceInstanceOnTransactionComplete 指定當交易完成時是否要釋放基礎服務執行個體。這個屬性的預設值為 true。下一個傳入訊息會導致建立新的基礎執行個體，並捨棄之前執行個體可能持有的任何每個交易狀態。釋放服務執行個體是服務執行的內部動作，並且不會影響用戶端可能已建立的任何現有連線或工作階段。這個功能等同於 COM+ 提供的 Just-in-Time 啟動功能。如果屬性是 true，則 ConcurrencyMode 必須等於 Single。否則，在啟動期間服務會發生無效組態驗證例外狀況。
  • TransactionIsolationLevel 指定服務內交易所使用的隔離等級，這個屬性會使用其中一個 IsolationLevel 值。如果本機隔離等級屬性不是 Unspecified，則傳入交易的隔離等級必須符合此本機屬性的設定。否則，就會拒絕傳入交易並且將錯誤傳回用戶端。如果 TransactionScopeRequired 是 true，並且沒有流動的交易，這個屬性會判定在本機建立之交易要使用的 IsolationLevel 值。如果 IsolationLevel 設定為 Unspecified，就會使用 IsolationLevel Serializable。
  • TransactionTimeout 指定在服務所建立之新交易必須完成的時間間隔。如果達到這個時間而交易尚未完成的話，交易就會中止。TimeSpan 會用來當做將 TransactionScopeRequired 設定為 true 之任何作業，以及建立新交易的 TransactionScope 逾時。從建立交易到完成兩階段交易認可通訊協定中的階段 1，所允許的逾時期間上限。所使用的逾時值永遠都是 TransactionTimeout 屬性和 transactionTimeout 組態設定之間較低的值。

OperationBehaviorAttribute

OperationBehaviorAttribute 屬性指定服務實作中方法的行為。您可以用來表示作業的特定執行行為。這個屬性 (Attribute) 的屬性 (Property)，不會影響服務合約的 Web 服務描述語言 (WSDL) 描述，而且只是啟用常見功能 (否則程式設計人員必須自行實作功能) 之 WCF 程式設計模型的項目。

這個屬性 (Attribute) 有下列交易特定屬性 (Property)：

  • TransactionScopeRequired 指定方法是否必須在現用交易的範圍內執行。預設為 false。如果沒有為方法設定 OperationBehaviorAttribute 屬性，這也表示該方法不會在交易中執行。如果作業不需要交易範圍，則存在於訊息標頭中的任何交易都不會啟動，而且保持為 OperationContext 的 IncomingMessageProperties 項目。如果作業需要交易範圍，則交易來源會衍生自下列其中一個：
    • 如果交易從用戶端流入，則會在使用分散式交易建立的交易範圍內執行方法。
    • 使用已佇列的傳輸時，會使用用來清除佇列訊息的交易。請注意，使用的交易並不是流動交易，因為不是由訊息的原始傳送者提供。
    • 自訂傳輸可以透過使用 TransportTransactionProperty 提供交易。
    • 如果上述都無法提供交易的外部來源，就會在呼叫方法之前立即建立新的 Transaction 執行個體。
  • TransactionAutoComplete 指定如果沒有發生未處理的例外狀況，方法執行的交易是否會自動完成。如果這個屬性是 true，當使用者方法在傳回時沒有發生例外狀況時，呼叫基礎結構會自動將交易標記為「已完成」。如果這個屬性是 false，則交易會附加至執行個體，並且只有在用戶端呼叫使用這個屬性標記為 true 的後續方法，或是如果後續方法明確地呼叫 SetTransactionComplete 時，才會標記為「已完成」。除非 TransactionAutoCompleteOnSessionClose 屬性設定為 true，否則無法在從未標記為「已完成」的交易中執行這些結果，並且也不會認可其中包含的工作。如果這個屬性設定為 true，您必須搭配工作階段使用通道，並且 InstanceContextMode 必須設定為 PerSession。