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

定義

名前空間:
System.Threading.Tasks.Dataflow
アセンブリ:
System.Threading.Tasks.Dataflow.dll
パッケージ:
System.Threading.Tasks.Dataflow v11.0.0-preview.4.26230.115
ソース:
JoinBlock.cs
ソース:
JoinBlock.cs
ソース:
JoinBlock.cs
ソース:
JoinBlock.cs
ソース:
JoinBlock.cs
ソース:
JoinBlock.cs
ソース:
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が返された場合は、その後、同じConsumeMessageとReleaseReservationを使用して、このメッセージのDataflowMessageHeaderまたはITargetBlock<TInput>を呼び出す必要があります。 そうしないと、ソースがそれ以上のメッセージをターゲットに伝達できない可能性があります。

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

適用対象