JoinBlock<T1,T2>.ISourceBlock<Tuple<T1,T2>>.ConsumeMessage 方法

定義

命名空間:

System.Threading.Tasks.Dataflow

組件:

System.Threading.Tasks.Dataflow.dll

套件:

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

來源:

JoinBlock.cs

將 所識別 DataflowMessageHeader 之訊息的擁有權從這個 ISourceBlock<TOutput> 實例傳遞至 ITargetBlock<TInput> 。

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

Tuple<T1,T2> ISourceBlock<Tuple<T1,T2>>.ConsumeMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<Tuple<T1,T2>> target, out bool messageConsumed);

abstract member System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2>>.ConsumeMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T1 * 'T2> * bool -> 'T1 * 'T2
override this.System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2>>.ConsumeMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T1 * 'T2> * bool -> 'T1 * 'T2

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

參數

messageHeader

DataflowMessageHeader

要取用的訊息的 DataflowMessageHeader。

target

ITargetBlock<Tuple<T1,T2>>

要取用訊息的 ITargetBlock<TInput>。

messageConsumed

Boolean

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

傳回

Tuple<T1,T2>

使用的訊息的值。 這會對應到的 DataflowMessageHeader 執行個體，可能會和先前已保留並作為 messageHeader 傳遞到此方法的執行個體不同。 取用 ITargetBlock<TInput> 必須使用傳回的值，而不是作為 messageValue 傳遞至 OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean) 的值。 如果無法取得要求的訊息，則傳回值為 null (在 Visual Basic 中為 Nothing)。

實作

ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean)

例外狀況

ArgumentException

messageHeader 無效。

ArgumentNullException

target 為 null (在 Visual Basic 中為 Nothing)。

備註

要 ITargetBlock<TInput> 取用訊息的 ，不需要從這個 ISourceBlock<TOutput> 實例連結。 此外，這個 ISourceBlock<TOutput> 實例可能從未將訊息直接 ITargetBlock<TInput> 提供給 。