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 在目标持有任何内部锁时，不得调用。 这样做会违反必要的锁层次结构，以避免数据流网络中出现死锁。