DataflowBlock.SendAsync Metoda

Definice

Obor názvů:

System.Threading.Tasks.Dataflow

Sestavení:

System.Threading.Tasks.Dataflow.dll

Balíček:

System.Threading.Tasks.Dataflow v11.0.0-preview.5.26302.115

Přetížení

Name	Description
SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)	Asynchronně nabízí zprávu cílovému bloku zprávy, což umožňuje odložení.
SendAsync<TInput>(ITargetBlock<TInput>, TInput)	Asynchronně nabízí zprávu cílovému bloku zprávy, což umožňuje odložení.

SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)

Zdroj:

DataflowBlock.cs

Asynchronně nabízí zprávu cílovému bloku zprávy, což umožňuje odložení.

public:
generic <typename TInput>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<bool> ^ SendAsync(System::Threading::Tasks::Dataflow::ITargetBlock<TInput> ^ target, TInput item, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<bool> SendAsync<TInput>(this System.Threading.Tasks.Dataflow.ITargetBlock<TInput> target, TInput item, System.Threading.CancellationToken cancellationToken);

static member SendAsync : System.Threading.Tasks.Dataflow.ITargetBlock<'Input> * 'Input * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

<Extension()>
Public Function SendAsync(Of TInput) (target As ITargetBlock(Of TInput), item As TInput, cancellationToken As CancellationToken) As Task(Of Boolean)

Parametry typu

TInput

Určuje typ dat, která se mají publikovat do cíle.

Parametry

target

ITargetBlock<TInput>

Cíl, do kterého se mají data publikovat.

item

TInput

Položka, která se nabízí cíli.

cancellationToken

CancellationToken

Token zrušení, se kterým chcete požádat o zrušení operace odeslání.

Návraty

Task<Boolean>

A Task<TResult> , který představuje asynchronní odeslání. Pokud cíl přijme a spotřebuje nabízený prvek během volání SendAsync, po návratu z volání se výsledek Task<TResult> dokončí a jeho Result vlastnost vrátí true. Pokud cíl odmítne nabízený prvek během volání, po návratu z volání se výsledek Task<TResult> dokončí a jeho Result vlastnost vrátí false. Pokud cíl odloží nabízený prvek, prvek se uloží do vyrovnávací paměti do doby, kdy cíl spotřebuje nebo uvolní, v tomto okamžiku úkol dokončí, s jeho Result indikací, zda byla zpráva spotřebována. Pokud se cíl nikdy nepokusí zprávu spotřebovat nebo uvolnit, vrácený úkol se nikdy nedokončí.

Pokud se vyžaduje zrušení před tím, než cíl úspěšně spotřebuje odeslaná data, vrácený úkol se dokončí ve stavu Zrušeno a data už nebudou pro cíl dostupná.

Výjimky

ArgumentNullException

Hodnota target má hodnotu null (v Visual Basic nic).

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

SendAsync<TInput>(ITargetBlock<TInput>, TInput)

Zdroj:

DataflowBlock.cs

Asynchronně nabízí zprávu cílovému bloku zprávy, což umožňuje odložení.

public:
generic <typename TInput>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<bool> ^ SendAsync(System::Threading::Tasks::Dataflow::ITargetBlock<TInput> ^ target, TInput item);

public static System.Threading.Tasks.Task<bool> SendAsync<TInput>(this System.Threading.Tasks.Dataflow.ITargetBlock<TInput> target, TInput item);

static member SendAsync : System.Threading.Tasks.Dataflow.ITargetBlock<'Input> * 'Input -> System.Threading.Tasks.Task<bool>

<Extension()>
Public Function SendAsync(Of TInput) (target As ITargetBlock(Of TInput), item As TInput) As Task(Of Boolean)

Parametry typu

TInput

Určuje typ dat, která se mají publikovat do cíle.

Parametry

target

ITargetBlock<TInput>

Cíl, do kterého se mají data publikovat.

item

TInput

Položka, která se nabízí cíli.

Návraty

Task<Boolean>

A Task<TResult> , který představuje asynchronní odeslání. Pokud cíl přijme a spotřebuje nabízený prvek během volání SendAsync<TInput>(ITargetBlock<TInput>, TInput), po návratu z volání bude výsledek Task<TResult> dokončen a jeho Result vlastnost vrátí true. Pokud cíl odmítne nabízený prvek během volání, po návratu z volání bude výsledek Task<TResult> dokončen a jeho Result vlastnost vrátí false. Pokud cíl odloží nabízený prvek, prvek se uloží do vyrovnávací paměti, dokud cíl spotřebuje nebo uvolní, v jakém okamžiku se úkol dokončí, a to Result s oznámením, zda byla zpráva spotřebována. Pokud se cíl nikdy nepokusí zprávu spotřebovat nebo uvolnit, vrácený úkol se nikdy nedokončí.

Výjimky

ArgumentNullException

To target je null.