ActionBlock<TInput> Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| ActionBlock<TInput>(Action<TInput>) |
Инициализирует новый экземпляр класса ActionBlock<TInput> с указанным действием. |
| ActionBlock<TInput>(Func<TInput,Task>) |
Инициализирует новый экземпляр класса ActionBlock<TInput> с указанным действием. |
| ActionBlock<TInput>(Action<TInput>, ExecutionDataflowBlockOptions) |
Инициализирует новый экземпляр класса ActionBlock<TInput> с указанным действием и параметрами конфигурации. |
| ActionBlock<TInput>(Func<TInput,Task>, ExecutionDataflowBlockOptions) |
Инициализирует новый экземпляр класса ActionBlock<TInput> с указанным действием и параметрами конфигурации. |
ActionBlock<TInput>(Action<TInput>)
Инициализирует новый экземпляр класса ActionBlock<TInput> с указанным действием.
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))Параметры
- action
- Action<TInput>
Действие, вызываемое при получении каждого элемента данных.
Исключения
action имеет значение null.
Применяется к
ActionBlock<TInput>(Func<TInput,Task>)
Инициализирует новый экземпляр класса ActionBlock<TInput> с указанным действием.
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))Параметры
Исключения
action имеет значение null.
Применяется к
ActionBlock<TInput>(Action<TInput>, ExecutionDataflowBlockOptions)
Инициализирует новый экземпляр класса ActionBlock<TInput> с указанным действием и параметрами конфигурации.
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)Параметры
- action
- Action<TInput>
Действие, вызываемое при получении каждого элемента данных.
- dataflowBlockOptions
- ExecutionDataflowBlockOptions
Параметр, с которым требуется настроить этот объект ActionBlock<TInput>.
Исключения
Примеры
В следующем примере показано, как использовать ActionBlock<TInput>(Action<TInput>, ExecutionDataflowBlockOptions) конструктор для создания нового ActionBlock<TInput> объекта. Этот пример кода является частью более крупного примера, предоставленного в разделе " Практическое руководство. Указание степени параллелизма в разделе блока потока данных ".
// 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)
Инициализирует новый экземпляр класса ActionBlock<TInput> с указанным действием и параметрами конфигурации.
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)Параметры
- dataflowBlockOptions
- ExecutionDataflowBlockOptions
Параметр, с которым требуется настроить этот объект ActionBlock<TInput>.