ISourceBlock<TOutput>.ReserveMessage メソッド

定義

名前空間:
System.Threading.Tasks.Dataflow
アセンブリ:
System.Threading.Tasks.Dataflow.dll
パッケージ:
System.Threading.Tasks.Dataflow v11.0.0-preview.4.26230.115
ソース:
ISourceBlock.cs
ソース:
ISourceBlock.cs
ソース:
ISourceBlock.cs
ソース:
ActionBlock.cs

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

public:
 bool ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<TOutput> ^ target);
public bool ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<out TOutput> target);
abstract member ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> -> bool
Public Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Out TOutput)) As Boolean

パラメーター

messageHeader
DataflowMessageHeader

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

target
ITargetBlock<TOutput>

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

返品

Boolean

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

例外

ArgumentException

messageHeaderが無効です。

ArgumentNullException

target は null です。

注釈

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

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

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

適用対象