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

定義

命名空間:

System.Threading.Tasks.Dataflow

組件:

System.Threading.Tasks.Dataflow.dll

套件:

System.Threading.Tasks.Dataflow v9.0.0-rc.2.24473.5

來源:

BatchedJoinBlock.cs

保留將 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 傳回 ，您後續必須針對具有相同 DataflowMessageHeader 和 ITargetBlock<TInput> 的這個訊息呼叫 ConsumeMessage 或 ReleaseReservation 。 如果您未這麼做，來源可能無法將任何進一步的訊息傳播至任何目標。

當目標持有任何內部鎖定時，請勿呼叫 ReserveMessage 。 這麼做會違反在資料流程網路中避免死結所需的鎖定階層。