The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

TransformManyBlock<TInput, TOutput> Class

Provides a dataflow block that invokes a provided Func<T, TResult> delegate for every data element received.

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

Inheritance Hierarchy

System::Object
System.Threading.Tasks.Dataflow::TransformManyBlock<TInput, TOutput>

Syntax

C++

generic<typename TInput, typename TOutput>
public ref class TransformManyBlock sealed : IPropagatorBlock<TInput, TOutput>, 
	ITargetBlock<TInput>, IReceivableSourceBlock<TOutput>, ISourceBlock<TOutput>, 
	IDataflowBlock

Type Parameters

TInput: Specifies the type of data received and operated on by this TransformManyBlock<TInput, TOutput>.

TOutput: Specifies the type of data output by this TransformManyBlock<TInput, TOutput>.

Constructors

	Name	Description
	TransformManyBlock<TInput, TOutput>(Func<TInput, IEnumerable<TOutput>^>^)	Initializes a new TransformManyBlock<TInput, TOutput> with the specified function.
	TransformManyBlock<TInput, TOutput>(Func<TInput, IEnumerable<TOutput>^>^, ExecutionDataflowBlockOptions^)	Initializes a new TransformManyBlock<TInput, TOutput> with the specified function and ExecutionDataflowBlockOptions.
	TransformManyBlock<TInput, TOutput>(Func<TInput, Task<IEnumerable<TOutput>^>^>^)	Initializes a new TransformManyBlock<TInput, TOutput> with the specified function.
	TransformManyBlock<TInput, TOutput>(Func<TInput, Task<IEnumerable<TOutput>^>^>^, ExecutionDataflowBlockOptions^)	Initializes a new TransformManyBlock<TInput, TOutput> with the specified function and ExecutionDataflowBlockOptions.

Properties

	Name	Description
	Completion	Gets a Task that represents the asynchronous operation and completion of the dataflow block.
	InputCount	Gets the number of input items waiting to be processed by this block.
	OutputCount	Gets the number of output items available to be received from this block.

Methods

	Name	Description
	Complete()	Signals to the IDataflowBlock that it should not accept nor produce any more messages nor consume any more postponed messages.
	Equals(Object^)	(Inherited from Object.)
	GetHashCode()	(Inherited from Object.)
	GetType()	(Inherited from Object.)
	LinkTo(ITargetBlock<TOutput>^, DataflowLinkOptions^)	Links the ISourceBlock<TOutput> to the specified ITargetBlock<TInput> .
	ToString()	Returns a string that represents the formatted name of this IDataflowBlock instance.(Overrides Object::ToString().)
	TryReceive(Predicate<TOutput>^, TOutput)	Attempts to synchronously receive an available output item from the IReceivableSourceBlock<TOutput>.
	TryReceiveAll(IList<TOutput>^)	Attempts to synchronously receive all available items from the IReceivableSourceBlock<TOutput>.

Explicit Interface Implementations

	Name	Description
	IDataflowBlock::Fault(Exception^)	Causes the IDataflowBlock to complete in a Faulted state.
	ISourceBlock<TOutput>::ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>^, Boolean)	Called by a linked ITargetBlock<TInput> to accept and consume a DataflowMessageHeader previously offered by this ISourceBlock<TOutput>.
	ISourceBlock<TOutput>::ReleaseReservation(DataflowMessageHeader, ITargetBlock<TOutput>^)	Called by a linked ITargetBlock<TInput> to release a previously reserved DataflowMessageHeader by this ISourceBlock<TOutput>.
	ISourceBlock<TOutput>::ReserveMessage(DataflowMessageHeader, ITargetBlock<TOutput>^)	Called by a linked ITargetBlock<TInput> to reserve a previously offered DataflowMessageHeader by this ISourceBlock<TOutput>.
	ITargetBlock<TInput>::OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>^, Boolean)	Offers a message to the ITargetBlock<TInput>, giving the target the opportunity to consume or postpone the message.

Extension Methods

	Name	Description
	AsObservable<TOutput>()	Creates a new IObservable<T> abstraction over the ISourceBlock<TOutput>.(Defined by DataflowBlock.)
	AsObserver<TInput>()	Creates a new IObserver<T> abstraction over the ITargetBlock<TInput>. (Defined by DataflowBlock.)
	LinkTo<TOutput>(ITargetBlock<TOutput>^)	Overloaded. Links the ISourceBlock<TOutput> to the specified ITargetBlock<TInput>. (Defined by DataflowBlock.)
	LinkTo<TOutput>(ITargetBlock<TOutput>^, DataflowLinkOptions^, Predicate<TOutput>^)	Overloaded. Links the ISourceBlock<TOutput> to the specified ITargetBlock<TInput> using the specified filter. (Defined by DataflowBlock.)
	LinkTo<TOutput>(ITargetBlock<TOutput>^, Predicate<TOutput>^)	Overloaded. Links the ISourceBlock<TOutput> to the specified ITargetBlock<TInput> using the specified filter. (Defined by DataflowBlock.)
	OutputAvailableAsync<TOutput>()	Overloaded. Provides a Task<TResult> that asynchronously monitors the source for available output.(Defined by DataflowBlock.)
	OutputAvailableAsync<TOutput>(CancellationToken)	Overloaded. Provides a Task<TResult> that asynchronously monitors the source for available output. (Defined by DataflowBlock.)
	Post<TInput>(TInput)	Posts an item to the ITargetBlock<TInput>.(Defined by DataflowBlock.)
	Receive<TOutput>()	Overloaded. Synchronously receives a value from a specified source.(Defined by DataflowBlock.)
	Receive<TOutput>(CancellationToken)	Overloaded. Synchronously receives a value from a specified source and provides a token to cancel the operation. (Defined by DataflowBlock.)
	Receive<TOutput>(TimeSpan)	Overloaded. Synchronously receives a value from a specified source, observing an optional time-out period.(Defined by DataflowBlock.)
	Receive<TOutput>(TimeSpan, CancellationToken)	Overloaded. Synchronously receives a value from a specified source, providing a token to cancel the operation and observing an optional time-out interval. (Defined by DataflowBlock.)
	ReceiveAsync<TOutput>()	Overloaded. Asynchronously receives a value from a specified source.(Defined by DataflowBlock.)
	ReceiveAsync<TOutput>(CancellationToken)	Overloaded. Asynchronously receives a value from a specified source and provides a token to cancel the operation. (Defined by DataflowBlock.)
	ReceiveAsync<TOutput>(TimeSpan)	Overloaded. Asynchronously receives a value from a specified source, observing an optional time-out period.(Defined by DataflowBlock.)
	ReceiveAsync<TOutput>(TimeSpan, CancellationToken)	Overloaded. Asynchronously receives a value from a specified source, providing a token to cancel the operation and observing an optional time-out interval. (Defined by DataflowBlock.)
	SendAsync<TInput>(TInput)	Overloaded. Asynchronously offers a message to the target message block, allowing for postponement.(Defined by DataflowBlock.)
	SendAsync<TInput>(TInput, CancellationToken)	Overloaded. Asynchronously offers a message to the target message block, allowing for postponement.(Defined by DataflowBlock.)
	TryReceive<TOutput>(TOutput)	Attempts to synchronously receive an item from the ISourceBlock<TOutput>.(Defined by DataflowBlock.)

Remarks

Note
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.

Thread Safety

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

Deutsch	English	Español	Français
Italiano	日本語	한국어	Português
Pусский	简体中文	繁體中文