TransformBlock<TInput,TOutput>.ISourceBlock<TOutput>.ReserveMessage メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
リンクされた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が無効です。
target は null です。
注釈
このITargetBlock<TInput>インスタンスにリンクされているISourceBlock<TOutput>インスタンスのみがReserveMessageを使用でき、このソースによって以前にターゲットに提供されたDataflowMessageHeaderインスタンスの予約にのみ使用する必要があります。
trueが返された場合、ITargetBlock<TInput>はその後、このメッセージのConsumeMessageまたはReleaseReservationを呼び出す必要があります。 これを行わないと、ソースがこのターゲットまたは他のターゲットにそれ以上メッセージを伝達できなくなる可能性があります。
ReserveMessage ターゲットが内部ロックを保持している間は呼び出してはなりません。 これを行うと、データフロー ネットワークでのデッドロックを回避するために必要なロック階層に違反します。