BroadcastBlock<T>.ISourceBlock<T>.ConsumeMessage Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Chamado por um ITargetBlock<TInput> vinculado para aceitar e consumir um DataflowMessageHeader anteriormente oferecido por este 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
Parâmetros
- messageHeader
- DataflowMessageHeader
O DataflowMessageHeader da mensagem que é consumida.
- target
- ITargetBlock<T>
O ITargetBlock<TInput> que consome a mensagem.
- messageConsumed
- Boolean
true
se a mensagem foi consumida com êxito; caso contrário, false
.
Retornos
- T
O valor da mensagem consumida. Isso pode corresponder a uma instância DataflowMessageHeader diferente que foi reservada anteriormente e passada como o messageHeader
para ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean). O ITargetBlock<TInput> de consumo deve usar o valor retornado em vez do valor passado como messageValue
por meio de OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean).
Se a mensagem solicitada não estiver disponível, o valor retornado será null
.
Implementações
Exceções
O messageHeader
não é válido.
O target
é null
.
Comentários
Somente ITargetBlock<TInput> instâncias vinculadas a essa ISourceBlock<TOutput> instância podem usar ConsumeMessage, e ela só deve ser usada para consumir DataflowMessageHeader instâncias oferecidas anteriormente por essa origem para o destino.