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

定义

命名空间:

System.Threading.Tasks.Dataflow

程序集:

System.Threading.Tasks.Dataflow.dll

Source:

JoinBlock.cs

保留将 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>。

返回

Boolean

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

实现

ReserveMessage(DataflowMessageHeader, ITargetBlock<TOutput>)

例外

ArgumentException

messageHeader 无效。

ArgumentNullException

target 为 null（在 Visual Basic 中为 Nothing）。

注解

ITargetBlock<TInput>要为其保留消息的 无需从此ISourceBlock<TOutput>实例链接。 此外，此 ISourceBlock<TOutput> 实例可能从未将消息直接提供给 ITargetBlock<TInput>。

如果 true 返回 ，则随后必须为此消息调用 ConsumeMessage 或 ReleaseReservation ，并使用相同的 DataflowMessageHeader 和 ITargetBlock<TInput>。 否则，源可能无法将任何进一步的消息传播到任何目标。

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