DataflowBlock.SendAsync Yöntem

Tanım

Ad Alanı:

System.Threading.Tasks.Dataflow

Bütünleştirilmiş Kod:

System.Threading.Tasks.Dataflow.dll

Aşırı Yüklemeler

SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)	Zaman uyumsuz olarak hedef ileti bloğuna bir ileti seçerek ertelemeye olanak tanır.
SendAsync<TInput>(ITargetBlock<TInput>, TInput)	Zaman uyumsuz olarak hedef ileti bloğuna bir ileti seçerek ertelemeye olanak tanır.

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

Kaynak:

DataflowBlock.cs

Zaman uyumsuz olarak hedef ileti bloğuna bir ileti seçerek ertelemeye olanak tanır.

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ür Parametreleri

TInput

Hedefe gönderilecek verilerin türünü belirtir.

Parametreler

target

ITargetBlock<TInput>

Verilerin gönderildiği hedef.

item

TInput

Hedefe sunulan öğe.

cancellationToken

CancellationToken

Gönderme işleminin iptalinin istendiği iptal belirteci.

Döndürülenler

Task<Boolean>

Task<TResult> Zaman uyumsuz göndermeyi temsil eden bir. Hedef SendAsync çağrısı sırasında sunulan öğeyi kabul eder ve kullanırsa, çağrıdan döndükten sonra sonuç Task<TResult> tamamlanır ve Result özelliği true değerini döndürür. Hedef, çağrı sırasında sunulan öğeyi reddederse, çağrıdan döndürülürken sonuç Task<TResult> tamamlanır ve Result özelliği false değerini döndürür. Hedef, sunulan öğeyi ertelerse, öğe hedef tarafından tüketilene veya serbest bırakılana kadar arabelleğe alınacaktır; bu noktada Görev tamamlanır Result ve iletinin tüketilip tüketilmediğini belirtir. Hedef hiçbir zaman iletiyi tüketmeye veya serbest bırakmaya çalışmazsa, döndürülen görev hiçbir zaman tamamlanmaz.

Hedef gönderilen verileri başarıyla tüketmeden önce iptal istenirse, döndürülen görev İptal Edildi durumunda tamamlanır ve veriler artık hedefte kullanılamaz.

Özel durumlar

ArgumentNullException

target null değeridir (Visual Basic'te hiçbir şey yoktur).

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

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

Kaynak:

DataflowBlock.cs

Zaman uyumsuz olarak hedef ileti bloğuna bir ileti seçerek ertelemeye olanak tanır.

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ür Parametreleri

TInput

Hedefe gönderilecek verilerin türünü belirtir.

Parametreler

target

ITargetBlock<TInput>

Verilerin gönderildiği hedef.

item

TInput

Hedefe sunulan öğe.

Döndürülenler

Task<Boolean>

Task<TResult> Zaman uyumsuz göndermeyi temsil eden bir. Hedef çağrısı sırasında SendAsync<TInput>(ITargetBlock<TInput>, TInput)teklif edilen öğeyi kabul ederse ve tüketiyorsa, çağrısından döndükten sonra sonuç Task<TResult> tamamlanır ve Result özelliği döndürülecektir true. Hedef, çağrı sırasında teklif edilen öğeyi reddederse, çağrıdan geri döndükten sonra sonuç Task<TResult> tamamlanır ve Result özelliği döndürülecektir false. Hedef, sunulan öğeyi ertelerse, öğe hedef tarafından tüketilene veya serbest bırakılıncaya kadar arabelleğe alınacaktır; bu noktada görev tamamlanır ve Result iletinin tüketilip tüketilmediğini belirtir. Hedef hiçbir zaman iletiyi tüketmeye veya serbest bırakmaya çalışmazsa, döndürülen görev hiçbir zaman tamamlanmaz.

Özel durumlar

ArgumentNullException

şeklindedir targetnull.