DataflowBlock.SendAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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.
