Services et transactions

Les applications Windows Communication Foundation (WCF) peuvent initier une transaction à partir d'un client et coordonner la transaction dans l'opération de service. Les clients peuvent initier une transaction et appeler plusieurs opérations de service et s'assurer que les opérations de service sont validées ou annulées en tant qu'unité unique.

Vous pouvez activer le comportement de transaction dans le contrat de service en spécifiant un ServiceBehaviorAttribute et en définissant ses propriétés TransactionIsolationLevel et TransactionScopeRequired pour les opérations de service qui requièrent des transactions clientes. Le paramètre TransactionAutoComplete spécifie si la transaction dans laquelle la méthode s'exécute est effectuée automatiquement si aucune exception non prise en charge n'est levée. Pour plus d'informations sur ces attributs, consultez Attributs de transaction ServiceModel.

Le travail effectué dans les opérations de service et géré par un gestionnaire de ressources, tel que l'enregistrement des mises à jour de base de données, fait partie de la transaction du client.

L'exemple suivant illustre l'utilisation des attributs ServiceBehaviorAttribute et OperationBehaviorAttribute pour contrôler le comportement de transaction du côté service.

[ServiceBehavior(TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable)]
public class CalculatorService: ICalculatorLog
{
    [OperationBehavior(TransactionScopeRequired = true,
                           TransactionAutoComplete = true)]
    public double Add(double n1, double n2)
    {
        recordToLog(String.Format("Added {0} to {1}", n1, n2));
        return n1 + n2;
    }

    [OperationBehavior(TransactionScopeRequired = true, 
                               TransactionAutoComplete = true)]
    public double Subtract(double n1, double n2)
    {
        recordToLog(String.Format("Subtracted {0} from {1}", n1, n2));
        return n1 - n2;
    }

    [OperationBehavior(TransactionScopeRequired = true, 
                                       TransactionAutoComplete = true)]
    public double Multiply(double n1, double n2)
    {
        recordToLog(String.Format("Multiplied {0} by {1}", n1, n2));
        return n1 * n2;
    }

    [OperationBehavior(TransactionScopeRequired = true, 
                                       TransactionAutoComplete = true)]
    public double Divide(double n1, double n2)
    {
        recordToLog(String.Format("Divided {0} by {1}", n1, n2));
        return n1 / n2;
    }

}

Vous pouvez activer les transactions et le flux de transactions en configurant des liaisons de client et de service pour utiliser le protocole WS-AtomicTransaction, et affecter à l'élément <transactionFlow> la valeur true, comme illustré dans l'exemple de configuration suivant.

<client>
    <endpoint address="net.tcp://localhost/ServiceModelSamples/service" 
          binding="netTcpBinding" 
          bindingConfiguration="netTcpBindingWSAT" 
          contract="Microsoft.ServiceModel.Samples.ICalculatorLog" />
</client>

<bindings>
    <netTcpBinding>
        <binding name="netTcpBindingWSAT"
                transactionFlow="true"
                transactionProtocol="WSAtomicTransactionOctober2004" />
     </netTcpBinding>
</bindings>

Les clients peuvent commencer une transaction en créant un TransactionScope et en appelant des opérations de service dans la portée de la transaction.

using (TransactionScope ts = new TransactionScope(TransactionScopeOption.RequiresNew))
{
    //Do work here
    ts.Complete();
}

Voir aussi

Concepts

Modèles de transaction

Autres ressources

Prise en charge transactionnelle dans System.ServiceModel
WS Transaction Flow