ISourceBlock<TOutput>.ReserveMessage 方法

定義

命名空間:

System.Threading.Tasks.Dataflow

組件:

System.Threading.Tasks.Dataflow.dll

套件:

System.Threading.Tasks.Dataflow v9.0.0-preview.4.24266.19

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

public:
 bool ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<TOutput> ^ target);

public bool ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<out TOutput> target);

abstract member ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> -> bool

Public Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Out TOutput)) As Boolean

參數

messageHeader

DataflowMessageHeader

保留的訊息的 DataflowMessageHeader。

target

ITargetBlock<TOutput>

保留訊息的 ITargetBlock<TInput>。

傳回

Boolean

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

例外狀況

ArgumentException

messageHeader 無效。

ArgumentNullException

target 為 null。

備註

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

如果 true 傳回 ， ITargetBlock<TInput> 則後續必須呼叫 ConsumeMessage 或 ReleaseReservation ，才能取得此訊息。 無法這麼做可能會導致來源無法將任何進一步的訊息傳播至這個或其他目標。

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