DataflowBlock.SendAsync 方法

來源:

DataflowBlock.cs

來源:

DataflowBlock.cs

來源:

DataflowBlock.cs

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)

類型參數

參數

傳回

表示非同步傳送的 Task<TResult>。 如果目標在呼叫 SendAsync 期間接受並取用所提供的專案，則從呼叫傳回時，產生的 Task<TResult> 將會完成，且其 Result 屬性會傳回 true。 如果目標在呼叫期間拒絕提供的專案，則從呼叫傳回時，結果 Task<TResult> 將會完成，且其 Result 屬性會傳回 false。 如果目標延後提供的專案，則會緩衝專案，直到目標取用或放開它為止，此時 Task 將會完成，並 Result 指出是否已取用訊息。 如果目標永遠不會嘗試使用或釋放訊息，則傳回的工作永遠不會完成。

如果在目標已成功地耗用傳送的資料之前已要求取消時，傳回的工作會在已取消狀態下完成，而資料將不再用於目標。

例外狀況

來源:

DataflowBlock.cs

來源:

DataflowBlock.cs

來源:

DataflowBlock.cs

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)

類型參數

參數

傳回

表示非同步傳送的 Task<TResult>。 如果在呼叫 SendAsync<TInput>(ITargetBlock<TInput>, TInput) 期間目標接受並使用所提供的項目，從呼叫返回時，所產生的 Task<TResult> 將完成，而且其 Result 屬性會傳回 true。 如果在呼叫期間目標拒絕所提供的項目，從呼叫返回時，所產生的 Task<TResult> 將完成，而且其 Result 屬性會傳回 false。 如果目標延後所提供的項目，則會緩衝項目直到目標耗用或釋放項目，此時將會完成工作，而其 Result 指出訊息是否已耗用。 如果目標永遠不會嘗試使用或釋放訊息，則傳回的工作永遠不會完成。

例外狀況