本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

DataflowBlock.SendAsync<TInput> 方法 (ITargetBlock<TInput>, TInput, CancellationToken)

 

以非同步的方式提供目標訊息區塊,可讓延後的訊息。

命名空間:   System.Threading.Tasks.Dataflow
組件:  System.Threading.Tasks.Dataflow (於 System.Threading.Tasks.Dataflow.dll)

public static Task<bool> SendAsync<TInput>(
	this ITargetBlock<TInput> target,
	TInput item,
	CancellationToken cancellationToken
)

參數

target
Type: System.Threading.Tasks.Dataflow.ITargetBlock<TInput>

要將資料公佈至目標。

item
Type: TInput

提供給目標項目。

cancellationToken
Type: System.Threading.CancellationToken

用來要求取消傳送作業的取消語彙基元。

傳回值

Type: System.Threading.Tasks.Task<Boolean>

A Task<TResult> ,表示非同步傳送。 如果目標接受並使用所提供的項目至 SendAsync 呼叫期間,在從呼叫返回產生 Task<TResult> 將完成且其 Result 屬性會傳回 true。 如果目標拒絕所提供的項目,在呼叫期間,在從呼叫返回產生 Task<TResult> 將完成且其 Result 屬性會傳回 false。 如果目標延後提供的項目,項目會緩衝處理這類時間之前目標會耗用或釋放它,此時將會完成工作,以其 Result ,指出是否已取用訊息。 如果目標不會嘗試使用或釋放訊息,永遠無法完成所傳回的工作。

如果目標已成功取用傳送的資料之前,已要求取消,則傳回的工作會完成已取消狀態,而且資料將無法再用於目標。

類型參數

TInput

指定要公佈到目標資料類型。

Exception Condition
ArgumentNullException

target 為 null (在 Visual Basic)。

回到頁首
顯示: