DataflowBlock.SendAsync Metódus

Definíció

Névtér:

System.Threading.Tasks.Dataflow

Szerelvény:

System.Threading.Tasks.Dataflow.dll

Csomag:

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

Túlterhelések

Name	Description
SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)	Aszinkron módon üzenetet küld a célüzenetblokknak, ami lehetővé teszi a halasztást.
SendAsync<TInput>(ITargetBlock<TInput>, TInput)	Aszinkron módon üzenetet küld a célüzenetblokknak, ami lehetővé teszi a halasztást.

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

Forrás:

DataflowBlock.cs

Aszinkron módon üzenetet küld a célüzenetblokknak, ami lehetővé teszi a halasztást.

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)

Típusparaméterek

TInput

Megadja a célnak közzéteendő adatok típusát.

Paraméterek

target

ITargetBlock<TInput>

Az a cél, amelyre az adatokat közzé kell tenni.

item

TInput

A célnak felajánlott elem.

cancellationToken

CancellationToken

Az a lemondási jogkivonat, amellyel a küldési művelet törlését kérheti.

Válaszok

Task<Boolean>

Az Task<TResult> aszinkron küldést jelképező. Ha a cél elfogadja és felhasználja a felajánlott elemet a SendAsync hívása során, a hívásból való visszatéréskor az eredmény Task<TResult> létrejön, és a tulajdonsága Result igaz lesz. Ha a cél a hívás során elutasítja a felajánlott elemet, a hívásból való visszatéréskor az eredményül kapott Task<TResult> elem befejeződik, és a tulajdonsága Result hamis lesz. Ha a cél elhalasztja a felajánlott elemet, a rendszer addig puffereli az elemet, amíg a cél fel nem használja vagy fel nem oldja azt. Ekkor a feladat befejeződik, és jelzi Result , hogy az üzenet fel lett-e használva. Ha a cél soha nem próbálja meg felhasználni vagy felszabadítani az üzenetet, a visszaadott feladat soha nem fejeződik be.

Ha a rendszer még azelőtt kéri a törlést, hogy a cél sikeresen felhasználta volna az elküldött adatokat, a visszaadott feladat a Mégse állapotban fejeződik be, és az adatok már nem lesznek elérhetők a cél számára.

Kivételek

ArgumentNullException

A target értéke null (a Visual Basic semmi).

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

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

Forrás:

DataflowBlock.cs

Aszinkron módon üzenetet küld a célüzenetblokknak, ami lehetővé teszi a halasztást.

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)

Típusparaméterek

TInput

Megadja a célnak közzéteendő adatok típusát.

Paraméterek

target

ITargetBlock<TInput>

Az a cél, amelyre az adatokat közzé kell tenni.

item

TInput

A célnak felajánlott elem.

Válaszok

Task<Boolean>

Az Task<TResult> aszinkron küldést jelképező. Ha a cél elfogadja és felhasználja a felajánlott elemet a hívás SendAsync<TInput>(ITargetBlock<TInput>, TInput)során, a hívásból való visszatéréskor az eredményül kapott Task<TResult> elem befejeződik, és a tulajdonsága Result vissza fog térni true. Ha a cél a hívás során elutasítja a felajánlott elemet, a hívásból való visszatéréskor az eredményül kapott Task<TResult> elem befejeződik, és a tulajdonsága Result vissza fog térni false. Ha a cél elhalasztja a felajánlott elemet, a rendszer addig puffereli az elemet, amíg a cél fel nem használja vagy fel nem oldja azt. Ekkor a feladat befejeződik, annak Result jelzésével, hogy az üzenet fel lett-e használva. Ha a cél soha nem próbálja meg felhasználni vagy felszabadítani az üzenetet, a visszaadott feladat soha nem fejeződik be.

Kivételek

ArgumentNullException

Az target van null.