Instructie: Gegevensstroomblokken ontkoppelen

In dit document wordt beschreven hoe u een doelgegevensstroomblok loskoppelt van de bron.

Voorbeeld

In het volgende voorbeeld worden drie TransformBlock<TInput,TOutput> objecten gemaakt, die elk de TrySolution methode aanroept om een waarde te berekenen. In dit voorbeeld is alleen het resultaat van de eerste aanroep naar TrySolution vereist om te voltooien.

using System;
using System.Threading;
using System.Threading.Tasks.Dataflow;

// Demonstrates how to unlink dataflow blocks.
class DataflowReceiveAny
{
   // Receives the value from the first provided source that has
   // a message.
   public static T ReceiveFromAny<T>(params ISourceBlock<T>[] sources)
   {
      // Create a WriteOnceBlock<T> object and link it to each source block.
      var writeOnceBlock = new WriteOnceBlock<T>(e => e);
      foreach (var source in sources)
      {
         // Setting MaxMessages to one instructs
         // the source block to unlink from the WriteOnceBlock<T> object
         // after offering the WriteOnceBlock<T> object one message.
         source.LinkTo(writeOnceBlock, new DataflowLinkOptions { MaxMessages = 1 });
      }
      // Return the first value that is offered to the WriteOnceBlock object.
      return writeOnceBlock.Receive();
   }

   // Demonstrates a function that takes several seconds to produce a result.
   static int TrySolution(int n, CancellationToken ct)
   {
      // Simulate a lengthy operation that completes within three seconds
      // or when the provided CancellationToken object is cancelled.
      SpinWait.SpinUntil(() => ct.IsCancellationRequested,
         new Random().Next(3000));

      // Return a value.
      return n + 42;
   }

   static void Main(string[] args)
   {
      // Create a shared CancellationTokenSource object to enable the
      // TrySolution method to be cancelled.
      var cts = new CancellationTokenSource();

      // Create three TransformBlock<int, int> objects.
      // Each TransformBlock<int, int> object calls the TrySolution method.
      Func<int, int> action = n => TrySolution(n, cts.Token);
      var trySolution1 = new TransformBlock<int, int>(action);
      var trySolution2 = new TransformBlock<int, int>(action);
      var trySolution3 = new TransformBlock<int, int>(action);

      // Post data to each TransformBlock<int, int> object.
      trySolution1.Post(11);
      trySolution2.Post(21);
      trySolution3.Post(31);

      // Call the ReceiveFromAny<T> method to receive the result from the
      // first TransformBlock<int, int> object to finish.
      int result = ReceiveFromAny(trySolution1, trySolution2, trySolution3);

      // Cancel all calls to TrySolution that are still active.
      cts.Cancel();

      // Print the result to the console.
      Console.WriteLine($"The solution is {result}.");

      cts.Dispose();
   }
}

/* Sample output:
The solution is 53.
*/

Imports System.Threading
Imports System.Threading.Tasks.Dataflow

' Demonstrates how to unlink dataflow blocks.
Friend Class DataflowReceiveAny
    ' Receives the value from the first provided source that has 
    ' a message.
    Public Shared Function ReceiveFromAny(Of T)(ParamArray ByVal sources() As ISourceBlock(Of T)) As T
        ' Create a WriteOnceBlock<T> object and link it to each source block.
        Dim writeOnceBlock = New WriteOnceBlock(Of T)(Function(e) e)
        For Each source In sources
            ' Setting MaxMessages to one instructs
            ' the source block to unlink from the WriteOnceBlock<T> object
            ' after offering the WriteOnceBlock<T> object one message.
            source.LinkTo(writeOnceBlock, New DataflowLinkOptions With {.MaxMessages = 1})
        Next source
        ' Return the first value that is offered to the WriteOnceBlock object.
        Return writeOnceBlock.Receive()
    End Function

    ' Demonstrates a function that takes several seconds to produce a result.
    Private Shared Function TrySolution(ByVal n As Integer, ByVal ct As CancellationToken) As Integer
        ' Simulate a lengthy operation that completes within three seconds
        ' or when the provided CancellationToken object is cancelled.
        SpinWait.SpinUntil(Function() ct.IsCancellationRequested, New Random().Next(3000))

        ' Return a value.
        Return n + 42
    End Function

    Shared Sub Main(ByVal args() As String)
        ' Create a shared CancellationTokenSource object to enable the 
        ' TrySolution method to be cancelled.
        Dim cts = New CancellationTokenSource()

        ' Create three TransformBlock<int, int> objects. 
        ' Each TransformBlock<int, int> object calls the TrySolution method.
        Dim action As Func(Of Integer, Integer) = Function(n) TrySolution(n, cts.Token)
        Dim trySolution1 = New TransformBlock(Of Integer, Integer)(action)
        Dim trySolution2 = New TransformBlock(Of Integer, Integer)(action)
        Dim trySolution3 = New TransformBlock(Of Integer, Integer)(action)

        ' Post data to each TransformBlock<int, int> object.
        trySolution1.Post(11)
        trySolution2.Post(21)
        trySolution3.Post(31)

        ' Call the ReceiveFromAny<T> method to receive the result from the 
        ' first TransformBlock<int, int> object to finish.
        Dim result As Integer = ReceiveFromAny(trySolution1, trySolution2, trySolution3)

        ' Cancel all calls to TrySolution that are still active.
        cts.Cancel()

        ' Print the result to the console.
        Console.WriteLine("The solution is {0}.", result)

        cts.Dispose()
    End Sub
End Class

' Sample output:
'The solution is 53.
'

Als u de waarde wilt ontvangen van het eerste TransformBlock<TInput,TOutput>-object dat is voltooid, definieert dit voorbeeld de ReceiveFromAny(T) methode. De methode ReceiveFromAny(T) accepteert een matrix van ISourceBlock<TOutput> objecten en koppelt elk van deze objecten aan een WriteOnceBlock<T>-object. Wanneer u de methode LinkTo gebruikt om een brongegevensstroomblok aan een doelblok te koppelen, worden berichten door de bron naar het doel doorgegeven wanneer er gegevens beschikbaar komen. Omdat de WriteOnceBlock<T> klasse alleen het eerste bericht accepteert dat wordt aangeboden, produceert de ReceiveFromAny(T) methode het resultaat door de methode Receive aan te roepen. Dit produceert het eerste bericht dat wordt aangeboden aan het WriteOnceBlock<T>-object. De methode LinkTo heeft een overbelaste versie die een DataflowLinkOptions object met een eigenschap MaxMessages gebruikt die, wanneer deze is ingesteld op 1, het bronblok instrueert om de koppeling van het doel ongedaan te maken nadat het doel één bericht van de bron heeft ontvangen. Het is belangrijk dat het WriteOnceBlock<T> object de koppeling van de bronnen ontkoppelt omdat de relatie tussen de matrix van bronnen en het WriteOnceBlock<T>-object niet meer nodig is nadat het WriteOnceBlock<T>-object een bericht heeft ontvangen.

Als u wilt dat de resterende aanroepen naar TrySolution worden beëindigd nadat een van deze aanroepen een waarde heeft berekend, neemt de TrySolution methode een CancellationToken object dat wordt geannuleerd nadat de aanroep naar ReceiveFromAny(T) retourneert. De methode SpinUntil wordt geretourneerd wanneer dit CancellationToken object wordt geannuleerd.

Zie ook

• gegevensstroom