ISourceBlock<TOutput>.ReserveMessage メソッド

定義

名前空間:

System.Threading.Tasks.Dataflow

アセンブリ:

System.Threading.Tasks.Dataflow.dll

パッケージ:

System.Threading.Tasks.Dataflow v9.0.0-rc.2.24473.5

この 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 です。

注釈

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

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

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