ActionBlock<TInput> Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| ActionBlock<TInput>(Action<TInput>) |
Inicializa uma nova instância da classe ActionBlock<TInput> com a ação especificada. |
| ActionBlock<TInput>(Func<TInput,Task>) |
Inicializa uma nova instância da classe ActionBlock<TInput> com a ação especificada. |
| ActionBlock<TInput>(Action<TInput>, ExecutionDataflowBlockOptions) |
Inicializa uma nova instância da classe ActionBlock<TInput> com as opções de ação e de configuração especificadas. |
| ActionBlock<TInput>(Func<TInput,Task>, ExecutionDataflowBlockOptions) |
Inicializa uma nova instância da classe ActionBlock<TInput> com as opções de ação e de configuração especificadas. |
ActionBlock<TInput>(Action<TInput>)
Inicializa uma nova instância da classe ActionBlock<TInput> com a ação especificada.
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))Parâmetros
- action
- Action<TInput>
A ação a ser invocada com cada elemento de dados recebido.
Exceções
action é null.
Aplica-se a
ActionBlock<TInput>(Func<TInput,Task>)
Inicializa uma nova instância da classe ActionBlock<TInput> com a ação especificada.
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))Parâmetros
Exceções
action é null.
Aplica-se a
ActionBlock<TInput>(Action<TInput>, ExecutionDataflowBlockOptions)
Inicializa uma nova instância da classe ActionBlock<TInput> com as opções de ação e de configuração especificadas.
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)Parâmetros
- action
- Action<TInput>
A ação a ser invocada com cada elemento de dados recebido.
- dataflowBlockOptions
- ExecutionDataflowBlockOptions
As opções com as quais este ActionBlock<TInput> será configurado.
Exceções
Exemplos
O exemplo a seguir mostra como usar o ActionBlock<TInput>(Action<TInput>, ExecutionDataflowBlockOptions) construtor para criar um novo ActionBlock<TInput> objeto. Este exemplo de código faz parte de um exemplo maior fornecido para o tópico How to: Specify the Degree of Parallelism in a Dataflow Block .
// 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
Aplica-se a
ActionBlock<TInput>(Func<TInput,Task>, ExecutionDataflowBlockOptions)
Inicializa uma nova instância da classe ActionBlock<TInput> com as opções de ação e de configuração especificadas.
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)Parâmetros
- dataflowBlockOptions
- ExecutionDataflowBlockOptions
As opções com as quais este ActionBlock<TInput> será configurado.