DataflowBlock.Encapsulate<TInput,TOutput> Metoda

Reference

Definice

Obor názvů:: System.Threading.Tasks.Dataflow

Sestavení:: System.Threading.Tasks.Dataflow.dll

Balíček:: System.Threading.Tasks.Dataflow v9.0.0-preview.3.24172.9

Zdroj:: DataflowBlock.cs

Zdroj:: DataflowBlock.cs

Zdroj:: DataflowBlock.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zapouzdří cíl a zdroj do jednoho šíření.

public:
generic <typename TInput, typename TOutput>
 static System::Threading::Tasks::Dataflow::IPropagatorBlock<TInput, TOutput> ^ Encapsulate(System::Threading::Tasks::Dataflow::ITargetBlock<TInput> ^ target, System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source);

public static System.Threading.Tasks.Dataflow.IPropagatorBlock<TInput,TOutput> Encapsulate<TInput,TOutput> (System.Threading.Tasks.Dataflow.ITargetBlock<TInput> target, System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source);

static member Encapsulate : System.Threading.Tasks.Dataflow.ITargetBlock<'Input> * System.Threading.Tasks.Dataflow.ISourceBlock<'Output> -> System.Threading.Tasks.Dataflow.IPropagatorBlock<'Input, 'Output>

Public Function Encapsulate(Of TInput, TOutput) (target As ITargetBlock(Of TInput), source As ISourceBlock(Of TOutput)) As IPropagatorBlock(Of TInput, TOutput)

Parametry typu

TInput

Určuje typ vstupu očekávaného cílem.

TOutput

Určuje typ výstupu vytvořeného zdrojem.

Parametry

target: ITargetBlock<TInput>

Cíl zapouzdření.

source: ISourceBlock<TOutput>

Zdroj k zapouzdření.

Návraty

IPropagatorBlock<TInput,TOutput>

Zapouzdřený cíl a zdroj

Poznámky

Metoda Encapsulate vyžaduje dva existující bloky: cílový blok (instance třídy, která implementuje ITargetBlock<TInput>) a zdrojový blok (instance třídy, která implementuje ISourceBlock<TOutput>). Encapsulate vytvoří novou instanci interní třídy, která připojí ITargetBlock<TInput> členy rozhraní k parametru target a ISourceBlock<TOutput> členy rozhraní k parametru source . Oba systémy ITargetBlock<TInput> a ISourceBlock<TOutput> jsou odvozeny z IDataflowBlock. Doplňování bloku se explicitně předává ze zdrojů cílům. Complete Proto jsou metody a Fault připojeny k cíli, zatímco Completion vlastnost je připojena ke zdroji. Musíte zajistit, aby po dokončení cílové poloviny byla zdrojová polovina dokončena nejvhodnějším způsobem; Příklad:

target.Completion.ContinueWith(completion => source.Complete());

Nebo pokud chcete rozšířit typ dokončení, můžete použít tento sofistikovanější kód:

target.Completion.ContinueWith(completion => { if (completion.IsFaulted)    

((IDataflowBlock)batchBlock).Fault(completion.Exception);   
else   
batchBlock.Complete();   
});

Musíte také explicitně zadat šíření zpráv z cíle do zdroje. Výhodou tohoto explicitního připojení je to, že vám dává volnost provádět jakékoli zpracování bez omezení mezi dvěma zapouzdřenými bloky. Můžete to udělat buď kódováním potřebného zpracování do delegátů bloků (pokud bloky přebírají delegáty), nebo vložením podsítě bloků mezi nimi. Jednodušší způsob je použít blok, který přijímá delegáty; Použijte například ActionBlock<TInput>, TransformBlock<TInput,TOutput>TransformManyBlock<TInput,TOutput> (pokud je k dispozici) nebo vlastní blok.

Platí pro