ActionBlock<TInput>.ITargetBlock<TInput>.OfferMessage メソッド

定義

データフロー ブロックにメッセージを提供し、メッセージを使用または延期する機会を提供します。

 virtual System::Threading::Tasks::Dataflow::DataflowMessageStatus System.Threading.Tasks.Dataflow.ITargetBlock<TInput>.OfferMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, TInput messageValue, System::Threading::Tasks::Dataflow::ISourceBlock<TInput> ^ source, bool consumeToAccept) = System::Threading::Tasks::Dataflow::ITargetBlock<TInput>::OfferMessage;
System.Threading.Tasks.Dataflow.DataflowMessageStatus ITargetBlock<TInput>.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, TInput messageValue, System.Threading.Tasks.Dataflow.ISourceBlock<TInput> source, bool consumeToAccept);
abstract member System.Threading.Tasks.Dataflow.ITargetBlock<TInput>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'Input * System.Threading.Tasks.Dataflow.ISourceBlock<'Input> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus
override this.System.Threading.Tasks.Dataflow.ITargetBlock<TInput>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'Input * System.Threading.Tasks.Dataflow.ISourceBlock<'Input> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus
Function OfferMessage (messageHeader As DataflowMessageHeader, messageValue As TInput, source As ISourceBlock(Of TInput), consumeToAccept As Boolean) As DataflowMessageStatus Implements ITargetBlock(Of TInput).OfferMessage

パラメーター

messageHeader
DataflowMessageHeader

提供されるメッセージのヘッダー。

messageValue
TInput

提供されるメッセージの値。

source
ISourceBlock<TInput>

メッセージを提供しているデータフロー ブロック。 これは null可能性があります。

consumeToAccept
Boolean

メッセージを使用するために、を返す前に、の呼び出し中に同期的にを呼び出すようにターゲットに指示する場合は a0/&

返品

提供されたメッセージの状態。 メッセージがターゲットによって受け入れられた場合、 Accepted が返され、ソースは提供されたメッセージを使用しなくなります。これは、ターゲットが所有しているためです。 メッセージがターゲットによって延期された場合、ターゲットが後でメッセージの使用または予約を試みる可能性があることを示す通知として Postponed が返されます。それまでの間、ソースはメッセージを所有し、他のブロックに提供できます。

ターゲットがそれ以外の場合はメッセージを延期したが、ソースが nullされた場合は、 Declined が返されます。

ターゲットがメッセージを受け入れようとしたが、ソースがメッセージを別のターゲットに配信したり、単に破棄したりしたためにメッセージを見逃した場合は、 NotAvailable が返されます。

ターゲットがメッセージを受け入れないことを選択した場合は、 Declined が返されます。 ターゲットがメッセージを受け入れないことを選択し、このソースから別のメッセージを受け入れない場合は、 DecliningPermanently が返されます。

実装

例外

messageHeader が無効です。

または、null 以外のconsumeToAcceptが指定されている場合にのみ、truesourceできます。

適用対象