DataflowBlock.SendAsync Methode

Definition

Namespace:

System.Threading.Tasks.Dataflow

Assembly:

System.Threading.Tasks.Dataflow.dll

Paket:

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

Überlädt

SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)	Gewährt dem Zielmeldungsblock asynchron eine Meldung an und ermöglicht einen Aufschub.
SendAsync<TInput>(ITargetBlock<TInput>, TInput)	Gewährt dem Zielmeldungsblock asynchron eine Meldung an und ermöglicht einen Aufschub.

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

Quelle:

DataflowBlock.cs

Gewährt dem Zielmeldungsblock asynchron eine Meldung an und ermöglicht einen Aufschub.

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)

Typparameter

TInput

Gibt den Typ der Daten an, die an das Ziel gesendet werden sollen.

Parameter

target

ITargetBlock<TInput>

Das Ziel, an das die Daten übermittelt werden sollen.

item

TInput

Das Element, das dem Ziel bereitgestellt wird.

cancellationToken

CancellationToken

Das Abbruchtoken, um den Abbruch des Sendevorgangs anzufordern.

Gibt zurück

Task<Boolean>

Ein Task<TResult>-Element, das den asynchronen Sendevorgangs darstellt. Wenn das Ziel das angebotene Element während des Aufrufs von SendAsync akzeptiert und nutzt, wird das resultierende Task<TResult> Element nach der Rückkehr vom Aufruf abgeschlossen, und seine Result Eigenschaft gibt true zurück. Wenn das Ziel das angebotene Element während des Aufrufs ablehnt, wird das resultierende Task<TResult> Element nach der Rückkehr vom Aufruf abgeschlossen, und seine Result Eigenschaft gibt false zurück. Wenn das Ziel das angebotene Element verschiebt, wird das Element so lange gepuffert, bis es vom Ziel verbraucht oder freigegeben wird. An diesem Punkt wird die Aufgabe abgeschlossen, wobei angegeben Result wird, ob die Nachricht verwendet wurde. Wenn das Ziel nie versucht, die Nachricht zu verarbeiten oder herauszugeben, wird die zurückgegebene Aufgabe nie abgeschlossen.

Wenn der Abbruch angefordert wird, bevor das Ziel erfolgreich die gesendeten Daten verarbeitet hat, wird die zurückgegebene Aufgabe im abgebrochenen Zustand abgeschlossen, und die Daten sind nicht mehr für das Ziel verfügbar.

Ausnahmen

ArgumentNullException

Der target ist NULL (Nothing in Visual Basic).

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

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

Quelle:

DataflowBlock.cs

Gewährt dem Zielmeldungsblock asynchron eine Meldung an und ermöglicht einen Aufschub.

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)

Typparameter

TInput

Gibt den Typ der Daten an, die an das Ziel gesendet werden sollen.

Parameter

target

ITargetBlock<TInput>

Das Ziel, an das die Daten übermittelt werden sollen.

item

TInput

Das Element, das dem Ziel bereitgestellt wird.

Gibt zurück

Task<Boolean>

Ein Task<TResult>-Element, das den asynchronen Sendevorgangs darstellt. Wenn das Ziel das angebotene Element während des Aufrufs von SendAsync<TInput>(ITargetBlock<TInput>, TInput) akzeptiert und nutzt, wird bei Rückgabe aus dem Aufruf das resultierende Task<TResult> abgeschlossen, und die Result-Eigenschaft gibt true zurück. Wenn das Ziel das angebotene Element während des Aufrufs ablehnt, wird bei Rückgabe aus dem Aufruf das resultierende Task<TResult> abgeschlossen, und die Result-Eigenschaft gibt false zurück. Wenn das Ziel das angebotene Element aufschiebt, wird das Element im Puffer gespeichert, bis es vom Ziel verwendet oder freigegeben wird. Zu diesem Punkt wird die Aufgabe ausgeführt, wobei Result angibt, ob die Meldung verarbeitet wurde. Wenn das Ziel nie versucht, die Nachricht zu verarbeiten oder herauszugeben, wird die zurückgegebene Aufgabe nie abgeschlossen.

Ausnahmen

ArgumentNullException

Der Jointyp (target) lautet null.