BufferBlock<T>.ISourceBlock<T>.ConsumeMessage 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
由連結的ITargetBlock<TInput>呼叫以接受及使用先前由此 DataflowMessageHeader 提供的 ISourceBlock<TOutput>。
virtual T System.Threading.Tasks.Dataflow.ISourceBlock<T>.ConsumeMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<T> ^ target, [Runtime::InteropServices::Out] bool % messageConsumed) = System::Threading::Tasks::Dataflow::ISourceBlock<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
。
傳回
使用的訊息的值。 這可能會對應到不同的 DataflowMessageHeader 執行個體,這個執行個體先前已保留並做為 messageHeader
傳遞到ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean)。 使用的 ITargetBlock<TInput>必須使用傳回的值,而不是使用做為 messageValue
經 OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean) 傳送的值。
如果無法使用要求的訊息,則傳回的值就是null
。
實作
例外狀況
messageHeader
無效。
target
為 null
。
備註
只有 ITargetBlock<TInput> 連結至這個 ISourceBlock<TOutput> 實例的實例可以使用 ConsumeMessage ,而且它只能用來取 DataflowMessageHeader 用此來源先前提供給目標的實例。