ActionBlock<TInput> Konstruktoren

Definition

Namespace:

System.Threading.Tasks.Dataflow

Assembly:

System.Threading.Tasks.Dataflow.dll

Überlädt

ActionBlock<TInput>(Action<TInput>)	Initialisiert eine neue Instanz der ActionBlock<TInput>-Klasse mit der angegebenen Aktion.
ActionBlock<TInput>(Func<TInput,Task>)	Initialisiert eine neue Instanz der ActionBlock<TInput>-Klasse mit der angegebenen Aktion.
ActionBlock<TInput>(Action<TInput>, ExecutionDataflowBlockOptions)	Initialisiert eine neue Instanz der ActionBlock<TInput>-Klasse mit der angegebenen Aktion und den Konfigurationsoptionen.
ActionBlock<TInput>(Func<TInput,Task>, ExecutionDataflowBlockOptions)	Initialisiert eine neue Instanz der ActionBlock<TInput>-Klasse mit der angegebenen Aktion und den Konfigurationsoptionen.

ActionBlock<TInput>(Action<TInput>)

Initialisiert eine neue Instanz der ActionBlock<TInput>-Klasse mit der angegebenen Aktion.

public:
 ActionBlock(Action<TInput> ^ action);

public ActionBlock (Action<TInput> action);

new System.Threading.Tasks.Dataflow.ActionBlock<'Input> : Action<'Input> -> System.Threading.Tasks.Dataflow.ActionBlock<'Input>

Public Sub New (action As Action(Of TInput))

Parameter

action

Action<TInput>

Die Aktion, die für jedes empfangene Datenelement aufzurufen.

Ausnahmen

ArgumentNullException

action ist null.

ActionBlock<TInput>(Func<TInput,Task>)

Initialisiert eine neue Instanz der ActionBlock<TInput>-Klasse mit der angegebenen Aktion.

public:
 ActionBlock(Func<TInput, System::Threading::Tasks::Task ^> ^ action);

public ActionBlock (Func<TInput,System.Threading.Tasks.Task> action);

new System.Threading.Tasks.Dataflow.ActionBlock<'Input> : Func<'Input, System.Threading.Tasks.Task> -> System.Threading.Tasks.Dataflow.ActionBlock<'Input>

Public Sub New (action As Func(Of TInput, Task))

Parameter

action

Func<TInput,Task>

Die Aktion, die für jedes empfangene Datenelement aufzurufen.

Ausnahmen

ArgumentNullException

action ist null.

ActionBlock<TInput>(Action<TInput>, ExecutionDataflowBlockOptions)

Initialisiert eine neue Instanz der ActionBlock<TInput>-Klasse mit der angegebenen Aktion und den Konfigurationsoptionen.

public:
 ActionBlock(Action<TInput> ^ action, System::Threading::Tasks::Dataflow::ExecutionDataflowBlockOptions ^ dataflowBlockOptions);

public ActionBlock (Action<TInput> action, System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions dataflowBlockOptions);

new System.Threading.Tasks.Dataflow.ActionBlock<'Input> : Action<'Input> * System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions -> System.Threading.Tasks.Dataflow.ActionBlock<'Input>

Public Sub New (action As Action(Of TInput), dataflowBlockOptions As ExecutionDataflowBlockOptions)

Parameter

action

Action<TInput>

Die Aktion, die für jedes empfangene Datenelement aufzurufen.

dataflowBlockOptions

ExecutionDataflowBlockOptions

Die Optionen, mit denen dieser ActionBlock<TInput> zu konfigurieren ist.

Ausnahmen

ArgumentNullException

action ist null.

- oder - dataflowBlockOptions ist null.

Beispiele

Im folgenden Beispiel wird gezeigt, wie der ActionBlock<TInput>(Action<TInput>, ExecutionDataflowBlockOptions) Konstruktor zum Erstellen eines neuen ActionBlock<TInput> Objekts verwendet wird. Dieses Codebeispiel ist Teil eines größeren Beispiels für das Gewusst wie: Angeben des Grads des Parallelismus in einem Dataflow-Blockthema .

// Performs several computations by using dataflow and returns the elapsed
// time required to perform the computations.
static TimeSpan TimeDataflowComputations(int maxDegreeOfParallelism,
   int messageCount)
{
   // Create an ActionBlock<int> that performs some work.
   var workerBlock = new ActionBlock<int>(
      // Simulate work by suspending the current thread.
      millisecondsTimeout => Thread.Sleep(millisecondsTimeout),
      // Specify a maximum degree of parallelism.
      new ExecutionDataflowBlockOptions
      {
         MaxDegreeOfParallelism = maxDegreeOfParallelism
      });

   // Compute the time that it takes for several messages to
   // flow through the dataflow block.

   Stopwatch stopwatch = new Stopwatch();
   stopwatch.Start();

   for (int i = 0; i < messageCount; i++)
   {
      workerBlock.Post(1000);
   }
   workerBlock.Complete();

   // Wait for all messages to propagate through the network.
   workerBlock.Completion.Wait();

   // Stop the timer and return the elapsed number of milliseconds.
   stopwatch.Stop();
   return stopwatch.Elapsed;
}

' Demonstrates how to specify the maximum degree of parallelism 
' when using dataflow.
Friend Class Program
   ' Performs several computations by using dataflow and returns the elapsed
   ' time required to perform the computations.
   Private Shared Function TimeDataflowComputations(ByVal maxDegreeOfParallelism As Integer, ByVal messageCount As Integer) As TimeSpan
      ' Create an ActionBlock<int> that performs some work.
      Dim workerBlock = New ActionBlock(Of Integer)(Function(millisecondsTimeout) Pause(millisecondsTimeout), New ExecutionDataflowBlockOptions() With { .MaxDegreeOfParallelism = maxDegreeOfParallelism})
         ' Simulate work by suspending the current thread.
         ' Specify a maximum degree of parallelism.

      ' Compute the time that it takes for several messages to 
      ' flow through the dataflow block.

      Dim stopwatch As New Stopwatch()
      stopwatch.Start()

      For i As Integer = 0 To messageCount - 1
         workerBlock.Post(1000)
      Next i
      workerBlock.Complete()

      ' Wait for all messages to propagate through the network.
      workerBlock.Completion.Wait()

      ' Stop the timer and return the elapsed number of milliseconds.
      stopwatch.Stop()
      Return stopwatch.Elapsed
   End Function

   Private Shared Function Pause(ByVal obj As Object)
      Thread.Sleep(obj)
      Return Nothing
   End Function

ActionBlock<TInput>(Func<TInput,Task>, ExecutionDataflowBlockOptions)

Initialisiert eine neue Instanz der ActionBlock<TInput>-Klasse mit der angegebenen Aktion und den Konfigurationsoptionen.

public:
 ActionBlock(Func<TInput, System::Threading::Tasks::Task ^> ^ action, System::Threading::Tasks::Dataflow::ExecutionDataflowBlockOptions ^ dataflowBlockOptions);

public ActionBlock (Func<TInput,System.Threading.Tasks.Task> action, System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions dataflowBlockOptions);

new System.Threading.Tasks.Dataflow.ActionBlock<'Input> : Func<'Input, System.Threading.Tasks.Task> * System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions -> System.Threading.Tasks.Dataflow.ActionBlock<'Input>

Public Sub New (action As Func(Of TInput, Task), dataflowBlockOptions As ExecutionDataflowBlockOptions)

Parameter

action

Func<TInput,Task>

Die Aktion, die für jedes empfangene Datenelement aufzurufen.

dataflowBlockOptions

ExecutionDataflowBlockOptions

Die Optionen, mit denen dieser ActionBlock<TInput> zu konfigurieren ist.

Ausnahmen

ArgumentNullException

action ist null.

- oder - dataflowBlockOptions ist null.