TransformBlock<TInput,TOutput>.ISourceBlock<TOutput>.ReserveMessage メソッド

定義

リンクされたITargetBlock<TInput>によって呼び出され、このDataflowMessageHeaderによって以前に提供されたISourceBlock<TOutput>を予約します。

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<TOutput>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<TOutput> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<TOutput>::ReserveMessage;
bool ISourceBlock<TOutput>.ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<TOutput> target);
abstract member System.Threading.Tasks.Dataflow.ISourceBlock<TOutput>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<TOutput>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> -> bool
Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of TOutput)) As Boolean Implements ISourceBlock(Of TOutput).ReserveMessage

パラメーター

messageHeader
DataflowMessageHeader

予約されているメッセージの DataflowMessageHeader

target
ITargetBlock<TOutput>

メッセージを予約する ITargetBlock<TInput>

返品

true メッセージが正常に予約された場合。それ以外の場合は false

実装

例外

messageHeaderが無効です。

targetnull です。

注釈

このITargetBlock<TInput>インスタンスにリンクされているISourceBlock<TOutput>インスタンスのみがReserveMessageを使用でき、このソースによって以前にターゲットに提供されたDataflowMessageHeaderインスタンスの予約にのみ使用する必要があります。

trueが返された場合、ITargetBlock<TInput>はその後、このメッセージのConsumeMessageまたはReleaseReservationを呼び出す必要があります。 これを行わないと、ソースがこのターゲットまたは他のターゲットにそれ以上メッセージを伝達できなくなる可能性があります。

ReserveMessage ターゲットが内部ロックを保持している間は呼び出してはなりません。 これを行うと、データフロー ネットワークでのデッドロックを回避するために必要なロック階層に違反します。

適用対象