共用方式為


TransformManyBlock<TInput,TOutput>.ISourceBlock<TOutput>.ReserveMessage 方法

定義

由連結的 ITargetBlock<TInput> 呼叫以保留先前由此 ISourceBlock<TOutput> 提供的 DataflowMessageHeader

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

參數

messageHeader
DataflowMessageHeader

保留的訊息的 DataflowMessageHeader

target
ITargetBlock<TOutput>

保留訊息的 ITargetBlock<TInput>

傳回

Boolean

如果成功保留訊息,則為 true,否則為false

實作

例外狀況

messageHeader 無效。

targetnull

備註

只有 ITargetBlock<TInput> 連結至這個 ISourceBlock<TOutput> 實例的實例可以使用 ReserveMessage ,而且它只能用來保留 DataflowMessageHeader 此來源先前提供給目標的實例。

如果 true 傳回 , ITargetBlock<TInput> 則後續必須針對此訊息呼叫 ConsumeMessageReleaseReservation 。 若無法這麼做,可能會導致來源無法將任何進一步的訊息傳播至此或其他目標。

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

適用於