ExecutionDataflowBlockOptions Class

 

Provides options used to configure the processing performed by dataflow blocks that process each message through the invocation of a user-provided delegate. These are dataflow blocks such as ActionBlock<TInput> and TransformBlock<TInput, TOutput>.

Namespace:   System.Threading.Tasks.Dataflow
Assembly:  System.Threading.Tasks.Dataflow (in System.Threading.Tasks.Dataflow.dll)

System::Object
System.Threading.Tasks.Dataflow::DataflowBlockOptions
System.Threading.Tasks.Dataflow::ExecutionDataflowBlockOptions

public ref class ExecutionDataflowBlockOptions : DataflowBlockOptions

NameDescription
System_CAPS_pubmethodExecutionDataflowBlockOptions()

Initializes a new ExecutionDataflowBlockOptions.

NameDescription
System_CAPS_pubpropertyBoundedCapacity

Gets or sets the maximum number of messages that may be buffered by the block.(Inherited from DataflowBlockOptions.)

System_CAPS_pubpropertyCancellationToken

Gets or sets the CancellationToken to monitor for cancellation requests. (Inherited from DataflowBlockOptions.)

System_CAPS_pubpropertyMaxDegreeOfParallelism

Gets the maximum number of messages that may be processed by the block concurrently.

System_CAPS_pubpropertyMaxMessagesPerTask

Gets or sets the maximum number of messages that may be processed per task.(Inherited from DataflowBlockOptions.)

System_CAPS_pubpropertyNameFormat

Gets or sets the format string to use when a block is queried for its name.(Inherited from DataflowBlockOptions.)

System_CAPS_pubpropertySingleProducerConstrained

Gets whether code using the dataflow block is constrained to one producer at a time.

System_CAPS_pubpropertyTaskScheduler

Gets or sets the TaskScheduler to use for scheduling tasks.(Inherited from DataflowBlockOptions.)

NameDescription
System_CAPS_pubmethodEquals(Object^)

(Inherited from Object.)

System_CAPS_protmethodFinalize()

(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

(Inherited from Object.)

System_CAPS_pubmethodGetType()

(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

(Inherited from Object.)

System_CAPS_pubmethodToString()

(Inherited from Object.)

System_CAPS_noteNote

The TPL Dataflow Library (System.Threading.Tasks.Dataflow namespace) is not distributed with the .NET Framework 4.5. To install the System.Threading.Tasks.Dataflow namespace, open your project in Visual Studio 2012, choose Manage NuGet Packages from the Project menu, and search online for the Microsoft.Tpl.Dataflow package.

ExecutionDataflowBlockOptions is mutable and can be configured through its properties.

When specific configuration options are not set, the following defaults are used:

Options

Default

TaskScheduler

Default

CancellationToken

None

MaxMessagesPerTask

DataflowBlockOptions.Unbounded (-1)

BoundedCapacity

DataflowBlockOptions.Unbounded (-1)

MaxDegreeOfParallelism

1

Dataflow block capture the state of the options at their construction. Subsequent changes to the provided ExecutionDataflowBlockOptions instance should not affect the behavior of a dataflow block.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: