JoinBlock<T1,T2>.ISourceBlock<Tuple<T1,T2>>.ReserveMessage 方法

定义

保留将由此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>要为其保留消息的项。

返回

true 如果已成功保留消息,则为否则,为 false.

实现

例外

无效 messageHeader

targetnull(Visual Basic 中没有任何内容)。

注解

ITargetBlock<TInput>要保留的消息不需要从此ISourceBlock<TOutput>实例进行链接。 此外,此 ISourceBlock<TOutput> 实例可能从未直接向该 ITargetBlock<TInput>实例提供消息。

如果true返回,则随后必须调用或为此消息调用ConsumeMessageReleaseReservation相同DataflowMessageHeaderITargetBlock<TInput>相同。 否则,源可能无法将任何进一步的消息传播到任何目标。

当目标持有任何内部锁时不要调用 ReserveMessage 。 这样做将违反必要的锁层次结构,以避免数据流网络中出现死锁。

适用于