BufferBlock<T>.ISourceBlock<T>.ReserveMessage 方法

定义

命名空间:

System.Threading.Tasks.Dataflow

程序集:

System.Threading.Tasks.Dataflow.dll

Source:

BufferBlock.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<T> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<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 当目标持有任何内部锁时，不得调用 。 这样做将违反避免数据流网络中出现死锁所需的锁层次结构。