ISourceBlock<TOutput>.ReserveMessage 方法

定义

命名空间:
System.Threading.Tasks.Dataflow
程序集:
System.Threading.Tasks.Dataflow.dll

由链接 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>则必须随后调用或为此消息调用ConsumeMessageReleaseReservation。 未能这样做可能会导致源无法将任何进一步的消息传播到此目标或其他目标。

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

适用于