Freigeben über


DataflowBlock.SendAsync Methode

Definition

Ü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
Quelle:
DataflowBlock.cs
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

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

Der target ist NULL (Nothing in Visual Basic).

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

Gilt für:

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

Quelle:
DataflowBlock.cs
Quelle:
DataflowBlock.cs
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

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

Der Jointyp (target) lautet null.

Gilt für: