通过

BatchedJoinBlock<T1,T2>.ISourceBlock<Tuple<IList<T1>,IList<T2>>>.ReserveMessage 方法

  • 参考

定义

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

保留将 DataflowMessageHeader 标识的消息的所有权从此 ISourceBlock<TOutput> 传递到 ITargetBlock<TInput> 的权限。

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<System.Collections.Generic.IList<T1>,System.Collections.Generic.IList<T2>>>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<Tuple<System::Collections::Generic::IList<T1> ^, System::Collections::Generic::IList<T2> ^> ^> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<Tuple<System::Collections::Generic::IList<T1> ^, System::Collections::Generic::IList<T2> ^> ^>::ReserveMessage;
bool ISourceBlock<Tuple<IList<T1>,IList<T2>>>.ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<Tuple<System.Collections.Generic.IList<T1>,System.Collections.Generic.IList<T2>>> target);
abstract member System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<System.Collections.Generic.IList<T1>,System.Collections.Generic.IList<T2>>>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<System.Collections.Generic.IList<'T1> * System.Collections.Generic.IList<'T2>> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<System.Collections.Generic.IList<T1>,System.Collections.Generic.IList<T2>>>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<System.Collections.Generic.IList<'T1> * System.Collections.Generic.IList<'T2>> -> bool
Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Tuple(Of IList(Of T1), IList(Of T2)))) As Boolean Implements ISourceBlock(Of Tuple(Of IList(Of T1), IList(Of T2))).ReserveMessage

参数

messageHeader
DataflowMessageHeader

要保留的消息的 DataflowMessageHeader。

target
ITargetBlock<Tuple<IList<T1>,IList<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返回，则必须随后调用或为此消息调用ConsumeMessageReleaseReservation相同DataflowMessageHeader且ITargetBlock<TInput>相同。 如果没有，源可能无法将任何进一步的消息传播到任何目标。

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

适用于