Activité Pick

L'activité Pick simplifie la modélisation d'un jeu de déclencheurs d'événements suivis de leurs gestionnaires correspondants. Une activité Pick contient une collection d'activités PickBranch, où chaque PickBranch est un couplage entre une activité Trigger et une activité Action. Au moment de l’exécution, les déclencheurs de toutes les branches sont exécutés en parallèle. Une fois qu'un déclencheur a été exécuté, son action correspondante est exécutée, et tous les autres déclencheurs sont annulés. Le comportement de l’activité .NET Framework 4.6.1 Pick est similaire à celui de l’activité .NET Framework 3.5 ListenActivity.

La capture d’écran suivante de l’exemple du SDK Utilisation de l’activité Pick montre une activité Pick avec deux branches. Une branche a un déclencheur appelé Read input, une activité personnalisée qui lit l’entrée à partir de la ligne de commande. La deuxième branche comporte un déclencheur d’activité Delay. Si l’activité Read input reçoit des données avant la fin de l’activité Delay, le délai Delay est annulé et un message d’accueil est écrit dans la console. Sinon, si l’activité Read input ne reçoit pas de données dans le délai alloué, elle est annulée et un message d’expiration du délai d’attente est écrit sur la console. C’est un modèle commun utilisé pour ajouter un délai d’attente à une action.

Bonnes pratiques

Lors de l'utilisation de Pick, la branche exécutée est la branche dont le déclencheur a fini de s'exécuter en premier. Conceptuellement, tous les déclencheurs s'exécutent en parallèle, et un déclencheur peut avoir exécuté la majorité de sa logique avant d'être annulé par la fin de l'exécution d'un autre déclencheur. Par conséquent, lors de l'utilisation de l'activité Pick, il est recommandé de traiter le déclencheur en tant que représentant d'un événement unique et d'y inclure le minimum de logique possible. Idéalement, le déclencheur doit contenir juste assez de logique pour recevoir un événement, et la totalité du traitement de cet événement doit être placée dans l'action de la branche. Cette méthode réduit le chevauchement entre l'exécution des déclencheurs. Prenons l'exemple d'un Pick avec deux déclencheurs, où chaque déclencheur contient une activité Receive suivie d'une logique supplémentaire. Si la logique supplémentaire ajoute un point inactif, il est possible que les deux activités Receive s'exécutent correctement. Un déclencheur sera exécuté entièrement, tandis que l'autre ne le sera que partiellement. Dans certains scénarios, il n'est pas possible d'accepter un message et de terminer ensuite partiellement le traitement. Par conséquent, si des activités de messagerie intégrées WF, telles que Receive et SendReply, sont utilisées alors que Receive est utilisé communément dans le déclencheur, SendReply et toute autre logique doivent être placées dans l'action dans la mesure du possible.

Utilisation de l'activité Pick dans le concepteur

Pour utiliser l’activité Pick dans le concepteur, recherchez Pick et PickBranch dans la boîte à outils. Faites glisser Pick pour le déposer sur le canevas. Par défaut, toute nouvelle activité Pick créée dans le concepteur contient deux branches. Pour ajouter des branches supplémentaires, faites glisser l’activité PickBranch et déposez-la à côté des branches existantes. Les activités peuvent être déposées sur l’activité Pick dans la zone Trigger ou dans la zone Action de n’importe quelle activité PickBranch.

Utilisation de l'activité Pick dans le code

L’activité Pick est utilisée en remplissant sa collection Branches avec les activités PickBranch. Chaque activité PickBranch a une propriété Trigger de type Activity. Une fois que l'activité spécifiée a été exécutée, l'action Action est exécutée à son tour.

L'exemple de code suivant montre comment utiliser une activité Pick pour implémenter un délai d'attente pour une activité qui lit une ligne de la console.

Sequence body = new Sequence()
{
    Variables = { name },
    Activities =
   {
       new System.Activities.Statements.Pick
        {
           Branches =
           {
               new PickBranch
               {
                   Trigger = new ReadLine
                   {
                      Result = name,
                      BookmarkName = "name"
                   },
                   Action = new WriteLine
                   {
                       Text = ExpressionServices.Convert<string>(ctx => "Hello " +
                           name.Get(ctx))
                   }
               },
               new PickBranch
               {
                   Trigger = new Delay
                   {
                      Duration = new TimeSpan(0, 0, 5)
                   },
                   Action = new WriteLine
                   {
                      Text = "Time is up."
                   }
               }
           }
       }
   }
};

<Sequence xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <Sequence.Variables>
    <Variable x:TypeArguments="x:String" Name="username" />
  </Sequence.Variables>
  <Pick>
    <PickBranch>
      <PickBranch.Trigger>
        <ReadLine BookmarkName="name" Result="username" />
      </PickBranch.Trigger>
      <WriteLine>[String.Concat("Hello ", username)]</WriteLine>
    </PickBranch>
    <PickBranch>
      <PickBranch.Trigger>
        <Delay>00:00:05</Delay>
      </PickBranch.Trigger>
      <WriteLine>Time is up.</WriteLine>
    </PickBranch>
  </Pick>
</Sequence>