Étendue de transaction de suppression

Cette rubrique s'applique à Windows Workflow Foundation 4.

L'exemple montre comment créer une activité SuppressTransactionScope personnalisée pour supprimer la transaction runtime ambiante, si elle existe.

Remarque :

Les exemples peuvent déjà être installés sur votre ordinateur. Recherchez le répertoire (par défaut) suivant avant de continuer. <LecteurInstall>:\WF_WCF_Samples Si ce répertoire n'existe pas, rendez-vous sur la page (éventuellement en anglais) des exemples Windows Communication Foundation (WCF) et Windows Workflow Foundation (WF) pour .NET Framework 4 pour télécharger tous les exemples Windows Communication Foundation (WCF) et WF. Cet exemple se trouve dans le répertoire suivant. <LecteurInstall>:\WF_WCF_Samples\WF\Scenario\Transactions\SuppressTransactionScope

Détails de l'exemple

L'activité personnalisée est utile pour empêcher une transaction d'être passée à un autre service si le flux de transaction est indésirable pour le scénario particulier. Le runtime du workflow dispose d'une prise en charge intégrée pour la suppression de la transaction ambiante dans la classe NativeActivity, mais pour utiliser cette prise en charge, il est nécessaire de créer un NativeActivity personnalisé tel que celui figurant dans cet exemple.

Le scénario est composé de trois parties. Tout d'abord, un TransactionScope crée une transaction runtime qui devient ambiante. Cela est vérifié par une activité personnalisée qui imprime les identificateurs locaux et distribués de la transaction. La transaction est ensuite passée à un service distant avant de commencer la deuxième partie. Pendant la deuxième partie, le workflow entre un SuppressTransactionScope et répète à nouveau le processus d'impression des identificateurs de transaction et de passage de la transaction. Toutefois, l'activité personnalisée ne trouve pas de transaction ambiante et le message passé au service ne contient pas la transaction. Par conséquent, le service crée une transaction, ce qui signifie que l'ID distribué imprimé sur le client et celui imprimé sur le service ne correspondent pas. La dernière partie se produit une fois que SuppressTransactionScope s'arrête et que la transaction runtime redevient ambiante, comme vérifié par un autre message au service avec un identificateur distribué qui correspond à l'identificateur du premier message.

L'activité elle-même dérive de NativeActivity car elle doit planifier une activité enfant et ajouter une propriété d'exécution. SuppressTransactionScope a un Variable de type RuntimeTransactionHandle, lequel doit être utilisé plutôt qu'un champ d'instance de type RuntimeTransactionHandle car le handle doit être initialisé. Variable<RuntimeTransactionHandle> est ajouté aux métadonnées de l'activité sous la forme d'une variable d'implémentation car il est utilisé en interne uniquement.

Lorsque l'activité est exécutée, elle commence par vérifier si un corps a été spécifié, et si tel est le cas, elle définit la propriété SuppressTransaction sur RuntimeTransactionHandle. Une fois la propriété définie, elle est ajoutée aux propriétés d'exécution et devient ambiante. Cela signifie que toute activité qui est un enfant de SuppressTransactionScope peut voir la propriété et, par conséquent, applique la suppression de la transaction runtime et entraîne la levée d'une exception par un TransactionScope imbriqué. Une fois le handle ajouté aux propriétés d'exécution, le corps est planifié pour s'exécuter.

Pour utiliser cet exemple

1. Ouvrez la solution SuppressTransactionScope.sln dans Visual Studio 2010.

2. Pour générer la solution, appuyez sur F6 ou sélectionnez Générer la solution dans le menu Générer.

3. Une fois que la génération a réussi, cliquez avec le bouton droit sur la solution, puis sélectionnez Définir les projets de démarrage. Dans la boîte de dialogue, sélectionnez Plusieurs projets de démarrage et vérifiez que l'action pour les deux projets est Démarrer.

4. Appuyez sur F5 ou sélectionnez Démarrer le débogage dans le menu Déboguer. Vous pouvez également appuyer sur CTRL+F5 ou sélectionner Exécuter sans débogage dans le menu Déboguer pour effectuer une exécution sans débogage.

   Remarque :
   Le serveur doit être en cours d'exécution avant de démarrer le client. La sortie de la fenêtre de console qui héberge le service indique le moment où il a démarré.

Remarque :

Les exemples peuvent déjà être installés sur votre ordinateur. Recherchez le répertoire (par défaut) suivant avant de continuer. <LecteurInstall>:\WF_WCF_Samples Si ce répertoire n'existe pas, rendez-vous sur la page (éventuellement en anglais) des exemples Windows Communication Foundation (WCF) et Windows Workflow Foundation (WF) pour .NET Framework 4 pour télécharger tous les exemples Windows Communication Foundation (WCF) et WF. Cet exemple se trouve dans le répertoire suivant. <LecteurInstall>:\WF_WCF_Samples\WF\Scenario\Transactions\SuppressTransactionScope