DataflowBlock.SendAsync Metoda

Definicja

Przestrzeń nazw:

System.Threading.Tasks.Dataflow

Zestaw:

System.Threading.Tasks.Dataflow.dll

Pakiet:

System.Threading.Tasks.Dataflow v9.0.0-preview.3.24172.9

Przeciążenia

SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)	Asynchronicznie oferuje komunikat do docelowego bloku komunikatów, co pozwala na odroczenie.
SendAsync<TInput>(ITargetBlock<TInput>, TInput)	Asynchronicznie oferuje komunikat do docelowego bloku komunikatów, co pozwala na odroczenie.

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

Źródło:

DataflowBlock.cs

Asynchronicznie oferuje komunikat do docelowego bloku komunikatów, co pozwala na odroczenie.

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

Określa typ danych do opublikowania w obiekcie docelowym.

Parametry

target

ITargetBlock<TInput>

Element docelowy, do którego mają być ogłaszane dane.

item

TInput

Element oferowany do elementu docelowego.

cancellationToken

CancellationToken

Token anulowania, za pomocą którego ma zażądać anulowania operacji wysyłania.

Zwraca

Task<Boolean>

Element Task<TResult> reprezentujący wysyłanie asynchroniczne. Jeśli element docelowy akceptuje i zużywa oferowany element podczas wywołania funkcji SendAsync, po powrocie z wywołania wynik Task<TResult> zostanie ukończony, a jego Result właściwość zwróci wartość true. Jeśli element docelowy odrzuci oferowany element podczas wywołania, po powrocie z wywołania wynik Task<TResult> zostanie ukończony, a jego Result właściwość zwróci wartość false. Jeśli element docelowy odrocza oferowany element, element zostanie buforowany do czasu, w którym element docelowy zużyje lub zwolni go, w którym momencie zadanie zostanie ukończone, z informacją Result o tym, czy komunikat został użyty. Jeśli obiekt docelowy nigdy nie próbuje używać lub zwalniać komunikatu, zwrócone zadanie nigdy nie zostanie ukończone.

Jeśli żądanie anulowania jest żądane przed pomyślnym użyciem wysłanych danych przez obiekt docelowy, zwrócone zadanie zostanie ukończone w stanie Anulowane, a dane nie będą już dostępne dla obiektu docelowego.

Wyjątki

ArgumentNullException

Wartość target ma wartość null (Nic w Visual Basic).

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

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

Źródło:

DataflowBlock.cs

Asynchronicznie oferuje komunikat do docelowego bloku komunikatów, co pozwala na odroczenie.

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

Określa typ danych do opublikowania w obiekcie docelowym.

Parametry

target

ITargetBlock<TInput>

Element docelowy, do którego mają być ogłaszane dane.

item

TInput

Element oferowany do elementu docelowego.

Zwraca

Task<Boolean>

Element Task<TResult> reprezentujący wysyłanie asynchroniczne. Jeśli element docelowy akceptuje i używa oferowanego elementu podczas wywołania metody SendAsync<TInput>(ITargetBlock<TInput>, TInput), po powrocie z wywołania wynik Task<TResult> zostanie ukończony, a jego Result właściwość zwróci truewartość . Jeśli element docelowy odrzuci oferowany element podczas wywołania, po powrocie z wywołania wynik Task<TResult> zostanie ukończony, a jego Result właściwość zwróci falsewartość . Jeśli element docelowy odrocza oferowany element, element zostanie buforowany do czasu, w którym element docelowy zużyje lub zwolni go, w którym momencie zadanie zostanie ukończone, z informacją Result o tym, czy komunikat został użyty. Jeśli obiekt docelowy nigdy nie próbuje używać lub zwalniać komunikatu, zwrócone zadanie nigdy nie zostanie ukończone.

Wyjątki

ArgumentNullException

Element target to null.