BatchBlock<T>.ISourceBlock<T[]>.ReserveMessage 方法

定义

命名空间:

System.Threading.Tasks.Dataflow

程序集:

System.Threading.Tasks.Dataflow.dll

包:

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

Source:

BatchBlock.cs

由链接的 ITargetBlock<TInput> 调用，以保留以前由此 DataflowMessageHeader 提供的 ISourceBlock<TOutput>。

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<cli::array <T> ^> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<cli::array <T> ^>::ReserveMessage;

bool ISourceBlock<T[]>.ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<T[]> target);

abstract member System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T[]> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T[]> -> bool

Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of T())) As Boolean Implements ISourceBlock(Of T()).ReserveMessage

参数

messageHeader

DataflowMessageHeader

要保留的消息的 DataflowMessageHeader。

target

ITargetBlock<T[]>

保留消息的 ITargetBlock<TInput>。

返回

Boolean

如果已成功保留该消息，则为 true；否则，为 false。

实现

ReserveMessage(DataflowMessageHeader, ITargetBlock<TOutput>)

例外

ArgumentException

messageHeader 无效。

ArgumentNullException

target 为 null。

注解

只有 ITargetBlock<TInput> 链接到此 ISourceBlock<TOutput> 实例的实例才能使用 ReserveMessage，并且它只能用于保留 DataflowMessageHeader 以前由此源提供给目标的实例。

如果 true 返回 ，则 ITargetBlock<TInput> 随后必须为此消息调用 ConsumeMessage 或 ReleaseReservation 。 否则，可能会导致源无法将任何进一步的消息传播到此或其他目标。

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