JoinBlock<T1,T2>.ISourceBlock<Tuple<T1,T2>>.ReserveMessage メソッド

定義

名前空間:

System.Threading.Tasks.Dataflow

アセンブリ:

System.Threading.Tasks.Dataflow.dll

パッケージ:

System.Threading.Tasks.Dataflow v9.0.0-preview.3.24172.9

ソース:

JoinBlock.cs

権利を予約して、DataflowMessageHeader によって識別されるメッセージの所有権をこの ISourceBlock<TOutput> から ITargetBlock<TInput> に渡します。

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2>>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<Tuple<T1, T2> ^> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<Tuple<T1, T2> ^>::ReserveMessage;

bool ISourceBlock<Tuple<T1,T2>>.ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<Tuple<T1,T2>> target);

abstract member System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2>>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T1 * 'T2> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2>>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T1 * 'T2> -> bool

Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Tuple(Of T1, T2))) As Boolean Implements ISourceBlock(Of Tuple(Of T1, T2)).ReserveMessage

パラメーター

messageHeader

DataflowMessageHeader

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

target

ITargetBlock<Tuple<T1,T2>>

メッセージが使用される ITargetBlock<TInput>。

戻り値

Boolean

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

実装

ReserveMessage(DataflowMessageHeader, ITargetBlock<TOutput>)

例外

ArgumentException

messageHeader が有効ではありません。

ArgumentNullException

target は null (Visual Basic では Nothing) です。

注釈

ITargetBlock<TInput>メッセージを予約する対象の は、このISourceBlock<TOutput>インスタンスからリンクする必要はありません。 さらに、この ISourceBlock<TOutput> インスタンスは メッセージを に直接 ITargetBlock<TInput>提供したことがない可能性があります。

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

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