BatchBlock<T>.ISourceBlock<T[]>.ConsumeMessage 方法

定義

命名空間:

System.Threading.Tasks.Dataflow

組件:

System.Threading.Tasks.Dataflow.dll

套件:

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

來源:

BatchBlock.cs

由連結的 ITargetBlock<TInput> 呼叫以接受及使用先前由此 ISourceBlock<TOutput> 提供的 DataflowMessageHeader。

 virtual cli::array <T> ^ System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ConsumeMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<cli::array <T> ^> ^ target, [Runtime::InteropServices::Out] bool % messageConsumed) = System::Threading::Tasks::Dataflow::ISourceBlock<cli::array <T> ^>::ConsumeMessage;

T[] ISourceBlock<T[]>.ConsumeMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<T[]> target, out bool messageConsumed);

abstract member System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ConsumeMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T[]> * bool -> 'T[]
override this.System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ConsumeMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T[]> * bool -> 'T[]

Function ConsumeMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of T()), ByRef messageConsumed As Boolean) As T() Implements ISourceBlock(Of T()).ConsumeMessage

參數

messageHeader

DataflowMessageHeader

使用的訊息的 DataflowMessageHeader。

target

ITargetBlock<T[]>

使用訊息的 ITargetBlock<TInput>。

messageConsumed

Boolean

如果成功使用訊息，則為 true，否則為false。

傳回

T[]

使用的訊息的值。 這可能會對應到不同的 DataflowMessageHeader 執行個體，這個執行個體先前已保留並做為 messageHeader 傳遞到ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean)。 使用的 ITargetBlock<TInput>必須使用傳回的值，而不是使用透過 OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean) 傳送做為 messageValue 的值。

如果無法使用要求的訊息，則傳回的值就是null。

實作

ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean)

例外狀況

ArgumentException

messageHeader 無效。

ArgumentNullException

target 為 null。

備註

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